npm - @ifc-lite/encoding - Versions diffs - 1.14.3 → 1.14.5 - Mend

@ifc-lite/encoding 1.14.3 → 1.14.5

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 (13) hide show

package/dist/guid.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export declare function uuidToIfcGuid(uuid: string): string;
+export declare function ifcGuidToUuid(ifcGuid: string): string;
+export declare function generateIfcGuid(): string;
+export declare function generateUuid(): string;
+export declare function isValidIfcGuid(ifcGuid: string): boolean;
+export declare function isValidUuid(uuid: string): boolean;
+//# sourceMappingURL=guid.d.ts.map

package/dist/guid.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../src/guid.ts"],"names":[],"mappings":"AAmBA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BlD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmCrD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAiBvD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD"}

package/dist/guid.js ADDED Viewed

@@ -0,0 +1,115 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * IFC GUID (IfcGloballyUniqueId) conversion utilities.
+ *
+ * IFC uses a 22-character base64 encoding of a 128-bit UUID using the custom
+ * buildingSMART alphabet. This module owns the canonical encode/decode and
+ * validation logic for that representation across the repo.
+ */
+const IFC_GUID_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$';
+const IFC_GUID_CHAR_TO_VALUE = {};
+for (let i = 0; i < IFC_GUID_CHARS.length; i++) {
+    IFC_GUID_CHAR_TO_VALUE[IFC_GUID_CHARS[i]] = i;
+}
+export function uuidToIfcGuid(uuid) {
+    const hex = uuid.replace(/-/g, '').toUpperCase();
+    if (hex.length !== 32) {
+        throw new Error(`Invalid UUID: expected 32 hex characters, got ${hex.length}`);
+    }
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < 16; i++) {
+        bytes[i] = parseInt(hex.substring(i * 2, i * 2 + 2), 16);
+    }
+    let result = '';
+    result += IFC_GUID_CHARS[(bytes[0] >> 6) & 0x03];
+    result += IFC_GUID_CHARS[bytes[0] & 0x3F];
+    for (let i = 1; i < 16; i += 3) {
+        const b0 = bytes[i] || 0;
+        const b1 = bytes[i + 1] || 0;
+        const b2 = bytes[i + 2] || 0;
+        result += IFC_GUID_CHARS[(b0 >> 2) & 0x3F];
+        result += IFC_GUID_CHARS[((b0 & 0x03) << 4) | ((b1 >> 4) & 0x0F)];
+        result += IFC_GUID_CHARS[((b1 & 0x0F) << 2) | ((b2 >> 6) & 0x03)];
+        result += IFC_GUID_CHARS[b2 & 0x3F];
+    }
+    return result;
+}
+export function ifcGuidToUuid(ifcGuid) {
+    if (ifcGuid.length !== 22) {
+        throw new Error(`Invalid IFC GUID: expected 22 characters, got ${ifcGuid.length}`);
+    }
+    const values = [];
+    for (const char of ifcGuid) {
+        const value = IFC_GUID_CHAR_TO_VALUE[char];
+        if (value === undefined) {
+            throw new Error(`Invalid IFC GUID character: ${char}`);
+        }
+        values.push(value);
+    }
+    const bytes = new Uint8Array(16);
+    bytes[0] = ((values[0] & 0x03) << 6) | (values[1] & 0x3F);
+    let byteIndex = 1;
+    for (let i = 2; i < 22; i += 4) {
+        const v0 = values[i];
+        const v1 = values[i + 1];
+        const v2 = values[i + 2];
+        const v3 = values[i + 3];
+        bytes[byteIndex++] = ((v0 & 0x3F) << 2) | ((v1 >> 4) & 0x03);
+        bytes[byteIndex++] = ((v1 & 0x0F) << 4) | ((v2 >> 2) & 0x0F);
+        bytes[byteIndex++] = ((v2 & 0x03) << 6) | (v3 & 0x3F);
+    }
+    let hex = '';
+    for (const byte of bytes) {
+        hex += byte.toString(16).padStart(2, '0');
+    }
+    return `${hex.substring(0, 8)}-${hex.substring(8, 12)}-${hex.substring(12, 16)}-${hex.substring(16, 20)}-${hex.substring(20, 32)}`.toLowerCase();
+}
+export function generateIfcGuid() {
+    return uuidToIfcGuid(generateUuid());
+}
+export function generateUuid() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < 16; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    bytes[6] = (bytes[6] & 0x0F) | 0x40;
+    bytes[8] = (bytes[8] & 0x3F) | 0x80;
+    let hex = '';
+    for (const byte of bytes) {
+        hex += byte.toString(16).padStart(2, '0');
+    }
+    return `${hex.substring(0, 8)}-${hex.substring(8, 12)}-${hex.substring(12, 16)}-${hex.substring(16, 20)}-${hex.substring(20, 32)}`;
+}
+export function isValidIfcGuid(ifcGuid) {
+    if (typeof ifcGuid !== 'string' || ifcGuid.length !== 22) {
+        return false;
+    }
+    const firstCharValue = IFC_GUID_CHAR_TO_VALUE[ifcGuid[0]];
+    if (firstCharValue === undefined || firstCharValue > 3) {
+        return false;
+    }
+    for (let i = 1; i < ifcGuid.length; i++) {
+        if (IFC_GUID_CHAR_TO_VALUE[ifcGuid[i]] === undefined) {
+            return false;
+        }
+    }
+    return true;
+}
+export function isValidUuid(uuid) {
+    if (typeof uuid !== 'string') {
+        return false;
+    }
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+}
+//# sourceMappingURL=guid.js.map

package/dist/guid.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"guid.js","sourceRoot":"","sources":["../src/guid.ts"],"names":[],"mappings":"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"}

package/dist/ifc-string.d.ts CHANGED Viewed

@@ -5,7 +5,16 @@
  * - \X4\XXXXXXXX\X0\ - Unicode 4-byte hex for chars outside BMP
  * - \X\XX\ - ISO-8859-1 hex encoding
  * - \S\X - Extended ASCII with escape
- * - \P..\ - Code page switches (stripped)
+ * - \P..\ - Code page switches (supported as directives and removed)
  */
 export declare function decodeIfcString(str: string): string;
+/**
+ * Encode a Unicode string to IFC STEP string escapes.
+ *
+ * - Printable ASCII (32..126) is kept as-is.
+ * - 8-bit values are encoded as \X\HH.
+ * - BMP values are encoded as \X2\HHHH\X0\.
+ * - Non-BMP values are encoded as \X4\HHHHHHHH\X0\.
+ */
+export declare function encodeIfcString(str: string): string;
 //# sourceMappingURL=ifc-string.d.ts.map

package/dist/ifc-string.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ifc-string.d.ts","sourceRoot":"","sources":["../src/ifc-string.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,~~CA4CnD~~"}
1	+ {"version":3,"file":"ifc-string.d.ts","sourceRoot":"","sources":["../src/ifc-string.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA6BnD"}

package/dist/ifc-string.js CHANGED Viewed

@@ -8,45 +8,104 @@
  * - \X4\XXXXXXXX\X0\ - Unicode 4-byte hex for chars outside BMP
  * - \X\XX\ - ISO-8859-1 hex encoding
  * - \S\X - Extended ASCII with escape
- * - \P..\ - Code page switches (stripped)
+ * - \P..\ - Code page switches (supported as directives and removed)
  */
 export function decodeIfcString(str) {
     if (!str || typeof str !== 'string')
         return str;
-    let result = str;
-    // Decode \X2\XXXX\X0\ patterns (Unicode 2-byte hex, can have multiple chars)
-    result = result.replace(/\\X2\\([0-9A-Fa-f]+)\\X0\\/g, (_, hex) => {
-        let decoded = '';
-        for (let i = 0; i < hex.length; i += 4) {
-            const charCode = parseInt(hex.substring(i, i + 4), 16);
-            if (!isNaN(charCode)) {
-                decoded += String.fromCharCode(charCode);
+    let result = '';
+    let i = 0;
+    while (i < str.length) {
+        if (str[i] !== '\\') {
+            result += str[i];
+            i += 1;
+            continue;
+        }
+        // Handle code page directives like \PA\, \PB\, ... by consuming them.
+        if (str[i + 1] === 'P' && str[i + 3] === '\\') {
+            i += 4;
+            continue;
+        }
+        // Handle \S\X where byte value is ord(X) + 128 in ISO-8859-1.
+        if (str[i + 1] === 'S' && str[i + 2] === '\\' && i + 3 < str.length) {
+            result += String.fromCharCode(str.charCodeAt(i + 3) + 128);
+            i += 4;
+            continue;
+        }
+        // Handle \X\HH (8-bit value from ISO 10646 row 0 / ISO-8859-1 overlap).
+        if (str[i + 1] === 'X' && str[i + 2] === '\\' && i + 5 <= str.length) {
+            const hex = str.slice(i + 3, i + 5);
+            if (/^[0-9A-Fa-f]{2}$/.test(hex)) {
+                result += String.fromCharCode(parseInt(hex, 16));
+                i += 5;
+                continue;
             }
         }
-        return decoded;
-    });
-    // Decode \X4\XXXXXXXX\X0\ patterns (Unicode 4-byte hex for chars outside BMP)
-    result = result.replace(/\\X4\\([0-9A-Fa-f]+)\\X0\\/g, (_, hex) => {
-        let decoded = '';
-        for (let i = 0; i < hex.length; i += 8) {
-            const codePoint = parseInt(hex.substring(i, i + 8), 16);
-            if (!isNaN(codePoint)) {
-                decoded += String.fromCodePoint(codePoint);
+        // Handle \X2\....\X0\ (UTF-16 hex code units, 4 chars each).
+        if (str.startsWith('\\X2\\', i)) {
+            const end = str.indexOf('\\X0\\', i + 4);
+            if (end !== -1) {
+                const hex = str.slice(i + 4, end);
+                if (hex.length % 4 === 0 && /^[0-9A-Fa-f]+$/.test(hex)) {
+                    for (let j = 0; j < hex.length; j += 4) {
+                        result += String.fromCharCode(parseInt(hex.slice(j, j + 4), 16));
+                    }
+                    i = end + 4;
+                    continue;
+                }
             }
         }
-        return decoded;
-    });
-    // Decode \X\XX\ patterns (ISO-8859-1 single byte)
-    result = result.replace(/\\X\\([0-9A-Fa-f]{2})/g, (_, hex) => {
-        const charCode = parseInt(hex, 16);
-        return !isNaN(charCode) ? String.fromCharCode(charCode) : '';
-    });
-    // Decode \S\X patterns (Latin extended, offset by 128)
-    result = result.replace(/\\S\\(.)/g, (_, char) => {
-        return String.fromCharCode(char.charCodeAt(0) + 128);
-    });
-    // Decode \P..\ code page switches (simplified - just remove them)
-    result = result.replace(/\\P[A-Z]?\\/g, '');
+        // Handle \X4\........\X0\ (Unicode scalar values, 8 hex digits each).
+        if (str.startsWith('\\X4\\', i)) {
+            const end = str.indexOf('\\X0\\', i + 4);
+            if (end !== -1) {
+                const hex = str.slice(i + 4, end);
+                if (hex.length % 8 === 0 && /^[0-9A-Fa-f]+$/.test(hex)) {
+                    for (let j = 0; j < hex.length; j += 8) {
+                        result += String.fromCodePoint(parseInt(hex.slice(j, j + 8), 16));
+                    }
+                    i = end + 4;
+                    continue;
+                }
+            }
+        }
+        // Unknown escape sequence: keep the backslash and move on.
+        result += str[i];
+        i += 1;
+    }
     return result;
 }
+/**
+ * Encode a Unicode string to IFC STEP string escapes.
+ *
+ * - Printable ASCII (32..126) is kept as-is.
+ * - 8-bit values are encoded as \X\HH.
+ * - BMP values are encoded as \X2\HHHH\X0\.
+ * - Non-BMP values are encoded as \X4\HHHHHHHH\X0\.
+ */
+export function encodeIfcString(str) {
+    if (!str || typeof str !== 'string')
+        return str;
+    let encoded = '';
+    for (const ch of str) {
+        const codePoint = ch.codePointAt(0);
+        if (codePoint === undefined) {
+            continue;
+        }
+        if (codePoint >= 32 && codePoint <= 126 && ch !== '\\') {
+            encoded += ch;
+            continue;
+        }
+        if (codePoint <= 0xFF) {
+            encoded += `\\X\\${codePoint.toString(16).toUpperCase().padStart(2, '0')}`;
+            continue;
+        }
+        if (codePoint <= 0xFFFF) {
+            encoded += `\\X2\\${codePoint.toString(16).toUpperCase().padStart(4, '0')}\\X0\\`;
+            continue;
+        }
+        encoded += `\\X4\\${codePoint.toString(16).toUpperCase().padStart(8, '0')}\\X0\\`;
+    }
+    return encoded;
+}
 //# sourceMappingURL=ifc-string.js.map

package/dist/ifc-string.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ifc-string.js","sourceRoot":"","sources":["../src/ifc-string.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAEhD,IAAI,MAAM,GAAG,~~GAAG~~,CAAC;~~IAEjB~~,~~6EAA6E;IAC7E~~,~~MAAM~~,GAAG,~~MAAM~~,CAAC,OAAO,CAAC,~~6BAA6B~~,EAAE,CAAC,CAAC,EAAE,GAAG,~~EAAE~~,~~EAAE~~;~~QAChE~~,IAAI,~~OAAO~~,~~GAAG~~,~~EAAE~~,CAAC;~~QACjB~~,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,~~MAAM~~,~~EAAE~~,CAAC,IAAI,CAAC,EAAE,CAAC;~~YACvC~~,MAAM,~~QAAQ~~,GAAG,~~QAAQ~~,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,~~EAAE~~,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;~~YACvD~~,IAAI,CAAC,~~KAAK~~,CAAC,~~QAAQ~~,CAAC,EAAE,CAAC;~~gBACrB~~,~~OAAO~~,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;~~YAC3C~~,CAAC;QACH,CAAC;~~QACD~~,~~OAAO~~,~~OAAO~~,CAAC~~;IACjB~~,CAAC,CAAC,CAAC~~;IAEH~~,~~8EAA8E~~;~~IAC9E~~,MAAM,GAAG,~~MAAM~~,CAAC,OAAO,CAAC,~~6BAA6B~~,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,~~EAAE~~;~~QAChE~~,IAAI,~~OAAO~~,GAAG,EAAE,CAAC;~~QACjB~~,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;~~YACvC~~,MAAM,~~SAAS~~,~~GAAG~~,QAAQ,CAAC,GAAG,CAAC,~~SAAS~~,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;~~YACxD~~,~~IAAI~~,CAAC,~~KAAK~~,CAAC,SAAS,CAAC,~~EAAE~~,CAAC;~~gBACtB~~,~~OAAO~~,IAAI,~~MAAM~~,CAAC,~~aAAa~~,CAAC,~~SAAS~~,CAAC,CAAC~~;YAC7C~~,CAAC;~~QACH~~,CAAC~~;QACD~~,OAAO,~~OAAO~~,CAAC~~;IACjB~~,CAAC,CAAC,CAAC;~~IAEH~~,~~kDAAkD~~;~~IAClD~~,MAAM,GAAG,MAAM,CAAC,~~OAAO~~,CAAC,~~wBAAwB~~,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;~~QAC3D~~,MAAM,QAAQ,GAAG,~~QAAQ~~,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;~~QACnC~~,~~OAAO~~,CAAC,~~KAAK~~,~~CAAC~~,~~QAAQ~~,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,~~YAAY~~,CAAC,~~QAAQ~~,CAAC,CAAC,CAAC,CAAC,~~EAAE~~,CAAC;~~IAC/D~~,CAAC,CAAC,CAAC;~~IAEH~~,~~uDAAuD~~;~~IACvD~~,~~MAAM~~,GAAG,MAAM,CAAC,~~OAAO~~,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;~~QAC/C~~,OAAO,~~MAAM~~,CAAC,~~YAAY~~,CAAC,IAAI,CAAC,~~UAAU~~,CAAC,CAAC,CAAC,~~GAAG~~,~~GAAG~~,CAAC,CAAC~~;IACvD~~,CAAC,CAAC,CAAC;~~IAEH~~,~~kEAAkE~~;~~IAClE~~,MAAM,GAAG,~~MAAM~~,CAAC,OAAO,CAAC,~~cAAc~~,EAAE,EAAE,CAAC,CAAC;~~IAE5C~~,OAAO,~~MAAM~~,CAAC;~~AAChB~~,CAAC"}
1	+ {"version":3,"file":"ifc-string.js","sourceRoot":"","sources":["../src/ifc-string.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
-export { decodeIfcString } from './ifc-string.js';
+export { decodeIfcString, encodeIfcString } from './ifc-string.js';
+export { uuidToIfcGuid, ifcGuidToUuid, generateIfcGuid, generateUuid, isValidIfcGuid, isValidUuid, } from './guid.js';
 export { parsePropertyValue } from './property-value.js';
 export type { ParsedPropertyValue } from './property-value.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;~~AAClD~~,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -1,6 +1,7 @@
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
-export { decodeIfcString } from './ifc-string.js';
+export { decodeIfcString, encodeIfcString } from './ifc-string.js';
+export { uuidToIfcGuid, ifcGuidToUuid, generateIfcGuid, generateUuid, isValidIfcGuid, isValidUuid, } from './guid.js';
 export { parsePropertyValue } from './property-value.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;~~AAClD~~,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/encoding",
-  "version": "1.14.3",
+  "version": "1.14.5",
   "description": "IFC string encoding/decoding and property value parsing for IFC-Lite",
   "type": "module",
   "main": "./dist/index.js",