@matter/general 0.16.0-alpha.0-20251205-dfb1e1556 → 0.16.0-alpha.0-20251209-d6072d23e

package/dist/esm/util/String.js

@@ -6,135 +6,6 @@
 import { ImplementationError } from "#MatterError.js";
 import { Bytes } from "./Bytes.js";
 import { isObject } from "./Type.js";
-function capitalize(text) {
-  return text[0].toUpperCase() + text.slice(1);
-}
-function camelize(name, upperFirst = false) {
-  const pieces = new Array();
-  let pieceStart = 0, sawUpper = false, sawLower = false, i = 0;
-  function addPiece(to) {
-    if (pieceStart < to) pieces.push(name.slice(pieceStart, to));
-    sawLower = sawUpper = false;
-  }
-  for (; i < name.length; i++) {
-    if (name[i] >= "A" && name[i] <= "Z") {
-      if (sawLower) {
-        addPiece(i);
-        pieceStart = i;
-      }
-      sawUpper = true;
-      continue;
-    }
-    if (name[i] >= "a" && name[i] <= "z") {
-      if (!sawLower) {
-        if (sawUpper) {
-          addPiece(i - 1);
-          pieceStart = i - 1;
-        }
-      }
-      sawLower = true;
-      continue;
-    }
-    addPiece(i);
-    if (name[i] >= "0" && name[i] <= "9" || name[i] === "$") {
-      pieces.push(name[i]);
-    }
-    pieceStart = i + 1;
-    continue;
-  }
-  addPiece(i);
-  let didFirst = false;
-  let result = pieces.map((piece) => {
-    let firstChar = piece[0];
-    if (upperFirst || didFirst) {
-      firstChar = firstChar.toUpperCase();
-    } else {
-      firstChar = firstChar.toLowerCase();
-      didFirst = true;
-    }
-    return `${firstChar}${piece.slice(1).toLowerCase()}`;
-  }).join("");
-  result = result.replace(/(\d)Ths/i, "$1ths");
-  return result;
-}
-function decamelize(name, separator = "-") {
-  const result = Array();
-  let needSeparator = false;
-  for (const c of name) {
-    if (c >= "A" && c <= "Z") {
-      if (needSeparator) {
-        result.push(separator);
-        needSeparator = false;
-      }
-      result.push(c.toLowerCase());
-    } else {
-      result.push(c);
-      needSeparator = true;
-    }
-  }
-  return result.join("");
-}
-function serialize(value) {
-  const visited = /* @__PURE__ */ new Set();
-  function asValidKey(key) {
-    if (key.match(/[a-z_$][\w$]*/i)) {
-      return key;
-    }
-    return JSON.stringify(key);
-  }
-  function serializeOne(value2) {
-    if (value2 === void 0) {
-      return;
-    }
-    if (value2 === null) {
-      return "null";
-    }
-    if (value2[serialize.SERIALIZE]) {
-      return value2[serialize.SERIALIZE]();
-    }
-    if (typeof value2 === "function") {
-      return;
-    }
-    if (typeof value2 === "bigint" || value2 instanceof BigInt) {
-      return value2.toString();
-    }
-    if (typeof value2 === "number" || value2 instanceof Number) {
-      return value2.toString();
-    }
-    if (typeof value2 === "string" || value2 instanceof String) {
-      return JSON.stringify(value2);
-    }
-    if (typeof value2 === "boolean") {
-      return value2 ? "true" : "false";
-    }
-    if (Bytes.isBytes(value2)) {
-      return Bytes.toHex(value2);
-    }
-    if (visited.has(value2)) {
-      return;
-    }
-    if (value2.toJSON) {
-      value2 = JSON.parse(JSON.stringify(value2));
-    }
-    try {
-      visited.add(value2);
-      if (Array.isArray(value2)) {
-        if (value2.length) {
-          return `[ ${value2.map(serializeOne).join(", ")} ]`;
-        }
-        return "[]";
-      }
-      const entries = Object.entries(value2).map(([k, v]) => [k, serializeOne(v)]).filter(([_k, v]) => v !== void 0).map(([k, v]) => `${asValidKey(k ?? "")}: ${v}`);
-      if (!entries.length) {
-        return "{}";
-      }
-      return `{ ${entries.join(", ")} }`;
-    } finally {
-      visited.delete(value2);
-    }
-  }
-  return serializeOne(value);
-}
 function asJson(value, space) {
   return JSON.stringify(
     value,
@@ -150,31 +21,6 @@ function asJson(value, space) {
     space
   );
 }
-((serialize2) => {
-  serialize2.SERIALIZE = Symbol("SERIALIZE");
-  function asIs(value) {
-    if (typeof value === "string") {
-      value = new String(value);
-    }
-    if (value !== void 0 && value !== null) {
-      value[serialize2.SERIALIZE] = function() {
-        return this.toString();
-      };
-    }
-    return value;
-  }
-  serialize2.asIs = asIs;
-  function isPrimitive(value) {
-    if (value === void 0 || value === null || value instanceof Date || ArrayBuffer.isView(value) || value[serialize2.SERIALIZE]) {
-      return true;
-    }
-    if (Array.isArray(value)) {
-      return false;
-    }
-    return typeof value !== "object";
-  }
-  serialize2.isPrimitive = isPrimitive;
-})(serialize || (serialize = {}));
 function describeList(setType, ...entries) {
   const text = Array();
   if (entries.length === 1) {
@@ -237,13 +83,25 @@ function serializeToJs(value) {
   parts.push("}");
   return parts.join("");
 }
+var hex;
+((hex2) => {
+  function fixed(value, width) {
+    return value.toString(16).padStart(width, "0");
+  }
+  hex2.fixed = fixed;
+  function byte(value) {
+    return fixed(value, 2);
+  }
+  hex2.byte = byte;
+  function word(value) {
+    return fixed(value, 4);
+  }
+  hex2.word = word;
+})(hex || (hex = {}));
 export {
   asJson,
-  camelize,
-  capitalize,
-  decamelize,
   describeList,
-  serialize,
+  hex,
   serializeToJs
 };
 //# sourceMappingURL=String.js.map

package/dist/esm/util/String.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/String.ts"],
-  "mappings": "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",
-  "names": ["value", "serialize", "parts"]
+  "mappings": "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",
+  "names": ["value", "parts", "hex"]
 }

package/dist/esm/util/identifier-case.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Make first character uppercase.
+ */
+export declare function capitalize<T extends string>(text: T): Capitalize<T>;
+/**
+ * Converts identifiers of the form "foo-bar", "foo_bar", "foo bar", "foo*bar",
+ * "fooBar" or "FOOBar" into "fooBar" or "FooBar".
+ */
+export declare function camelize(name: string, upperFirst?: boolean): string;
+/**
+ * Converts an identifier from CamelCase to snake_case.
+ */
+export declare function decamelize(name: string, separator?: string): string;
+//# sourceMappingURL=identifier-case.d.ts.map

package/dist/esm/util/identifier-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-case.d.ts","sourceRoot":"","sources":["../../../src/util/identifier-case.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GACE,UAAU,CAAC,CAAC,CAAC,CAClE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,UAAQ,UA8DxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,UAgBvD"}

package/dist/esm/util/identifier-case.js

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function capitalize(text) {
+  return text[0].toUpperCase() + text.slice(1);
+}
+function camelize(name, upperFirst = false) {
+  const pieces = new Array();
+  let pieceStart = 0, sawUpper = false, sawLower = false, i = 0;
+  function addPiece(to) {
+    if (pieceStart < to) pieces.push(name.slice(pieceStart, to));
+    sawLower = sawUpper = false;
+  }
+  for (; i < name.length; i++) {
+    if (name[i] >= "A" && name[i] <= "Z") {
+      if (sawLower) {
+        addPiece(i);
+        pieceStart = i;
+      }
+      sawUpper = true;
+      continue;
+    }
+    if (name[i] >= "a" && name[i] <= "z") {
+      if (!sawLower) {
+        if (sawUpper) {
+          addPiece(i - 1);
+          pieceStart = i - 1;
+        }
+      }
+      sawLower = true;
+      continue;
+    }
+    addPiece(i);
+    if (name[i] >= "0" && name[i] <= "9" || name[i] === "$") {
+      pieces.push(name[i]);
+    }
+    pieceStart = i + 1;
+    continue;
+  }
+  addPiece(i);
+  let didFirst = false;
+  let result = pieces.map((piece) => {
+    let firstChar = piece[0];
+    if (upperFirst || didFirst) {
+      firstChar = firstChar.toUpperCase();
+    } else {
+      firstChar = firstChar.toLowerCase();
+      didFirst = true;
+    }
+    return `${firstChar}${piece.slice(1).toLowerCase()}`;
+  }).join("");
+  result = result.replace(/(\d)Ths/i, "$1ths");
+  return result;
+}
+function decamelize(name, separator = "-") {
+  const result = Array();
+  let needSeparator = false;
+  for (const c of name) {
+    if (c >= "A" && c <= "Z") {
+      if (needSeparator) {
+        result.push(separator);
+        needSeparator = false;
+      }
+      result.push(c.toLowerCase());
+    } else {
+      result.push(c);
+      needSeparator = true;
+    }
+  }
+  return result.join("");
+}
+export {
+  camelize,
+  capitalize,
+  decamelize
+};
+//# sourceMappingURL=identifier-case.js.map

package/dist/esm/util/identifier-case.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/identifier-case.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AASO,SAAS,WAA6B,MAAS;AAClD,SAAQ,KAAK,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC;AAChD;AAMO,SAAS,SAAS,MAAc,aAAa,OAAO;AACvD,QAAM,SAAS,IAAI,MAAc;AACjC,MAAI,aAAa,GACb,WAAW,OACX,WAAW,OACX,IAAI;AAER,WAAS,SAAS,IAAY;AAC1B,QAAI,aAAa,GAAI,QAAO,KAAK,KAAK,MAAM,YAAY,EAAE,CAAC;AAC3D,eAAW,WAAW;AAAA,EAC1B;AAEA,SAAO,IAAI,KAAK,QAAQ,KAAK;AACzB,QAAI,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,KAAK,KAAK;AAClC,UAAI,UAAU;AACV,iBAAS,CAAC;AACV,qBAAa;AAAA,MACjB;AACA,iBAAW;AACX;AAAA,IACJ;AAEA,QAAI,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,KAAK,KAAK;AAClC,UAAI,CAAC,UAAU;AACX,YAAI,UAAU;AACV,mBAAS,IAAI,CAAC;AACd,uBAAa,IAAI;AAAA,QACrB;AAAA,MACJ;AACA,iBAAW;AACX;AAAA,IACJ;AAEA,aAAS,CAAC;AAEV,QAAK,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,KAAK,OAAQ,KAAK,CAAC,MAAM,KAAK;AACvD,aAAO,KAAK,KAAK,CAAC,CAAC;AAAA,IACvB;AAEA,iBAAa,IAAI;AACjB;AAAA,EACJ;AACA,WAAS,CAAC;AAEV,MAAI,WAAW;AACf,MAAI,SAAS,OACR,IAAI,WAAS;AACV,QAAI,YAAY,MAAM,CAAC;AACvB,QAAI,cAAc,UAAU;AACxB,kBAAY,UAAU,YAAY;AAAA,IACtC,OAAO;AACH,kBAAY,UAAU,YAAY;AAClC,iBAAW;AAAA,IACf;AACA,WAAO,GAAG,SAAS,GAAG,MAAM,MAAM,CAAC,EAAE,YAAY,CAAC;AAAA,EACtD,CAAC,EACA,KAAK,EAAE;AAGZ,WAAS,OAAO,QAAQ,YAAY,OAAO;AAE3C,SAAO;AACX;AAKO,SAAS,WAAW,MAAc,YAAY,KAAK;AACtD,QAAM,SAAS,MAAc;AAC7B,MAAI,gBAAgB;AACpB,aAAW,KAAK,MAAM;AAClB,QAAI,KAAK,OAAO,KAAK,KAAK;AACtB,UAAI,eAAe;AACf,eAAO,KAAK,SAAS;AACrB,wBAAgB;AAAA,MACpB;AACA,aAAO,KAAK,EAAE,YAAY,CAAC;AAAA,IAC/B,OAAO;AACH,aAAO,KAAK,CAAC;AACb,sBAAgB;AAAA,IACpB;AAAA,EACJ;AACA,SAAO,OAAO,KAAK,EAAE;AACzB;",
+  "names": []
+}

package/dist/esm/util/index.d.ts

@@ -22,8 +22,10 @@ export * from "./FormattedText.js";
 export * from "./Function.js";
 export * from "./GeneratedClass.js";
 export * from "./Github.js";
+export * from "./identifier-case.js";
 export * from "./Ip.js";
 export * from "./Lifecycle.js";
+export * from "./Lifetime.js";
 export * from "./Map.js";
 export * from "./MockFetch.js";
 export * from "./Multiplex.js";
@@ -33,6 +35,7 @@ export * from "./Number.js";
 export * from "./Observable.js";
 export * from "./PromiseQueue.js";
 export * from "./Promises.js";
+export * from "./serialize.js";
 export * from "./Set.js";
 export * from "./Singleton.js";
 export * from "./Streams.js";

package/dist/esm/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/esm/util/index.js

@@ -22,8 +22,10 @@ export * from "./FormattedText.js";
 export * from "./Function.js";
 export * from "./GeneratedClass.js";
 export * from "./Github.js";
+export * from "./identifier-case.js";
 export * from "./Ip.js";
 export * from "./Lifecycle.js";
+export * from "./Lifetime.js";
 export * from "./Map.js";
 export * from "./MockFetch.js";
 export * from "./Multiplex.js";
@@ -33,6 +35,7 @@ export * from "./Number.js";
 export * from "./Observable.js";
 export * from "./PromiseQueue.js";
 export * from "./Promises.js";
+export * from "./serialize.js";
 export * from "./Set.js";
 export * from "./Singleton.js";
 export * from "./Streams.js";

package/dist/esm/util/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/index.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/esm/util/serialize.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Like JSON.stringify but targets well-formed JS and is slightly more readable.
+ */
+export declare function serialize(value: unknown): string | undefined;
+export declare namespace serialize {
+    /**
+     * Custom serialization function key.
+     */
+    const SERIALIZE: unique symbol;
+    /**
+     * Mark a value as serialized so the serializer just uses its string
+     * representation.
+     */
+    function asIs(value: any): any;
+    /**
+     * Test whether a value serializes as a structure or a primitive.
+     */
+    function isPrimitive(value: any): boolean;
+}
+//# sourceMappingURL=serialize.d.ts.map

package/dist/esm/util/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/util/serialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,sBAyEvC;AAED,yBAAiB,SAAS,CAAC;IACvB;;OAEG;IACI,MAAM,SAAS,eAAsB,CAAC;IAE7C;;;OAGG;IACH,SAAgB,IAAI,CAAC,KAAK,EAAE,GAAG,OAU9B;IAED;;OAEG;IACH,SAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,WAgBrC;CACJ"}

package/dist/esm/util/serialize.js

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "./Bytes.js";
+function serialize(value) {
+  const visited = /* @__PURE__ */ new Set();
+  function asValidKey(key) {
+    if (key.match(/[a-z_$][\w$]*/i)) {
+      return key;
+    }
+    return JSON.stringify(key);
+  }
+  function serializeOne(value2) {
+    if (value2 === void 0) {
+      return;
+    }
+    if (value2 === null) {
+      return "null";
+    }
+    if (value2[serialize.SERIALIZE]) {
+      return value2[serialize.SERIALIZE]();
+    }
+    if (typeof value2 === "function") {
+      return;
+    }
+    if (typeof value2 === "bigint" || value2 instanceof BigInt) {
+      return value2.toString();
+    }
+    if (typeof value2 === "number" || value2 instanceof Number) {
+      return value2.toString();
+    }
+    if (typeof value2 === "string" || value2 instanceof String) {
+      return JSON.stringify(value2);
+    }
+    if (typeof value2 === "boolean") {
+      return value2 ? "true" : "false";
+    }
+    if (Bytes.isBytes(value2)) {
+      return Bytes.toHex(value2);
+    }
+    if (visited.has(value2)) {
+      return;
+    }
+    if (value2.toJSON) {
+      value2 = JSON.parse(JSON.stringify(value2));
+    }
+    try {
+      visited.add(value2);
+      if (Array.isArray(value2)) {
+        if (value2.length) {
+          return `[ ${value2.map(serializeOne).join(", ")} ]`;
+        }
+        return "[]";
+      }
+      const entries = Object.entries(value2).map(([k, v]) => [k, serializeOne(v)]).filter(([_k, v]) => v !== void 0).map(([k, v]) => `${asValidKey(k ?? "")}: ${v}`);
+      if (!entries.length) {
+        return "{}";
+      }
+      return `{ ${entries.join(", ")} }`;
+    } finally {
+      visited.delete(value2);
+    }
+  }
+  return serializeOne(value);
+}
+((serialize2) => {
+  serialize2.SERIALIZE = /* @__PURE__ */ Symbol("SERIALIZE");
+  function asIs(value) {
+    if (typeof value === "string") {
+      value = new String(value);
+    }
+    if (value !== void 0 && value !== null) {
+      value[serialize2.SERIALIZE] = function() {
+        return this.toString();
+      };
+    }
+    return value;
+  }
+  serialize2.asIs = asIs;
+  function isPrimitive(value) {
+    if (value === void 0 || value === null || value instanceof Date || ArrayBuffer.isView(value) || value[serialize2.SERIALIZE]) {
+      return true;
+    }
+    if (Array.isArray(value)) {
+      return false;
+    }
+    return typeof value !== "object";
+  }
+  serialize2.isPrimitive = isPrimitive;
+})(serialize || (serialize = {}));
+export {
+  serialize
+};
+//# sourceMappingURL=serialize.js.map

package/dist/esm/util/serialize.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/serialize.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,aAAa;AAKf,SAAS,UAAU,OAAgB;AACtC,QAAM,UAAU,oBAAI,IAAI;AAExB,WAAS,WAAW,KAAa;AAC7B,QAAI,IAAI,MAAM,gBAAgB,GAAG;AAC7B,aAAO;AAAA,IACX;AACA,WAAO,KAAK,UAAU,GAAG;AAAA,EAC7B;AAEA,WAAS,aAAaA,QAAoC;AACtD,QAAIA,WAAU,QAAW;AACrB;AAAA,IACJ;AACA,QAAIA,WAAU,MAAM;AAChB,aAAO;AAAA,IACX;AACA,QAAKA,OAA8C,UAAU,SAAS,GAAG;AACrE,aAAQA,OAA8C,UAAU,SAAS,EAAE;AAAA,IAC/E;AACA,QAAI,OAAOA,WAAU,YAAY;AAC7B;AAAA,IACJ;AACA,QAAI,OAAOA,WAAU,YAAYA,kBAAiB,QAAQ;AACtD,aAAOA,OAAM,SAAS;AAAA,IAC1B;AACA,QAAI,OAAOA,WAAU,YAAYA,kBAAiB,QAAQ;AACtD,aAAOA,OAAM,SAAS;AAAA,IAC1B;AACA,QAAI,OAAOA,WAAU,YAAYA,kBAAiB,QAAQ;AACtD,aAAO,KAAK,UAAUA,MAAK;AAAA,IAC/B;AACA,QAAI,OAAOA,WAAU,WAAW;AAC5B,aAAOA,SAAQ,SAAS;AAAA,IAC5B;AACA,QAAI,MAAM,QAAQA,MAAK,GAAG;AACtB,aAAO,MAAM,MAAMA,MAAK;AAAA,IAC5B;AAGA,QAAI,QAAQ,IAAIA,MAAK,GAAG;AACpB;AAAA,IACJ;AACA,QAAKA,OAA+B,QAAQ;AACxC,MAAAA,SAAQ,KAAK,MAAM,KAAK,UAAUA,MAAK,CAAC;AAAA,IAC5C;AAEA,QAAI;AACA,cAAQ,IAAIA,MAAK;AAEjB,UAAI,MAAM,QAAQA,MAAK,GAAG;AACtB,YAAIA,OAAM,QAAQ;AACd,iBAAO,KAAKA,OAAM,IAAI,YAAY,EAAE,KAAK,IAAI,CAAC;AAAA,QAClD;AACA,eAAO;AAAA,MACX;AAEA,YAAM,UAAU,OAAO,QAAQA,MAAW,EACrC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EACpC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,MAAM,MAAS,EACnC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE;AAEnD,UAAI,CAAC,QAAQ,QAAQ;AACjB,eAAO;AAAA,MACX;AAEA,aAAO,KAAK,QAAQ,KAAK,IAAI,CAAC;AAAA,IAClC,UAAE;AACE,cAAQ,OAAOA,MAAK;AAAA,IACxB;AAAA,EACJ;AAEA,SAAO,aAAa,KAAK;AAC7B;AAAA,CAEO,CAAUC,eAAV;AAII,EAAMA,WAAA,YAAY,uBAAO,WAAW;AAMpC,WAAS,KAAK,OAAY;AAC7B,QAAI,OAAO,UAAU,UAAU;AAC3B,cAAQ,IAAI,OAAO,KAAK;AAAA,IAC5B;AACA,QAAI,UAAU,UAAa,UAAU,MAAM;AACvC,YAAMA,WAAA,SAAS,IAAI,WAAY;AAC3B,eAAO,KAAK,SAAS;AAAA,MACzB;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAVO,EAAAA,WAAS;AAeT,WAAS,YAAY,OAAY;AACpC,QACI,UAAU,UACV,UAAU,QACV,iBAAiB,QACjB,YAAY,OAAO,KAAK,KACxB,MAAMA,WAAA,SAAS,GACjB;AACE,aAAO;AAAA,IACX;AAEA,QAAI,MAAM,QAAQ,KAAK,GAAG;AACtB,aAAO;AAAA,IACX;AAEA,WAAO,OAAO,UAAU;AAAA,EAC5B;AAhBO,EAAAA,WAAS;AAAA,GAzBH;",
+  "names": ["value", "serialize"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.16.0-alpha.0-20251205-dfb1e1556",
+    "version": "0.16.0-alpha.0-20251209-d6072d23e",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^2.0.1"
     },
     "devDependencies": {
-        "@matter/testing": "0.16.0-alpha.0-20251205-dfb1e1556"
+        "@matter/testing": "0.16.0-alpha.0-20251209-d6072d23e"
     },
     "files": [
         "dist/**/*",

package/src/MatterError.ts

@@ -6,7 +6,7 @@
 
 import { NodeJsStyleInspectable } from "#log/NodeJsStyleInspectable.js";
 import type { MaybePromise } from "#util/Promises.js";
-import { decamelize } from "#util/String.js";
+import { decamelize } from "#util/identifier-case.js";
 import { errorOf } from "./util/Error.js";
 
 const codes = new WeakMap<{}, string>();

package/src/codec/DerTypes.ts

@@ -6,6 +6,7 @@
 
 import { InternalError } from "#MatterError.js";
 import { Bytes } from "#util/Bytes.js";
+import { hex } from "#util/String.js";
 import {
     ContextTagged,
     ContextTaggedBytes,
@@ -112,7 +113,7 @@ export namespace X520 {
      * Also registers the OID in the reverse lookup map immediately.
      */
     const GenericString_X520 = (id: number, fieldName: string) => {
-        const oidHex = `5504${id.toString(16).padStart(2, "0")}`;
+        const oidHex = `5504${hex.byte(id)}`;
         // Register in reverse lookup map immediately at function creation time
         if (OID_TO_FIELD_MAP[oidHex] !== undefined && OID_TO_FIELD_MAP[oidHex] !== fieldName) {
             throw new InternalError(