@arcmantle/chronicle 1.0.2 → 1.0.3

package/dist/nameof.d.ts

@@ -1,7 +1,6 @@
 export type Nameof<T> = (m: T extends object ? T : any) => any;
 /**
- * Returns either the last part of a objects path  \
- * or dotted path if the fullPath flag is set to true.
+ * Returns the dot-separated property path captured from the selector expression.
  */
 export declare const nameof: <const T>(expression: (instance: T) => any) => string;
 /**

package/dist/nameof.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nameof.d.ts","sourceRoot":"","sources":["../src/nameof.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC;AAG/D;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAG,MAKlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAG,MAAM,EAKhF,CAAC"}
+{"version":3,"file":"nameof.d.ts","sourceRoot":"","sources":["../src/nameof.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC;AAG/D;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAG,MAoBlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAG,MAAM,EAqBhF,CAAC"}

package/dist/nameof.js

@@ -1,30 +1,56 @@
-import { normalizePropertyKey } from "./symbol-id.js";
-// nameof property path is stored here for retrieval.
-const propertyThatWasAccessed = [];
-// Proxy objects to store the property path.
+import { getSymbolId } from "./symbol-id.js";
+// Pre-allocated array to minimize allocations
+const propertyPath = [];
+// Fast path length tracking to avoid .length lookups
+let pathLength = 0;
+// Inline property key normalization for maximum speed
+const normalizeKey = (prop) => typeof prop === 'symbol' ? getSymbolId(prop) : prop;
+// Highly optimized proxy with minimal overhead
 const proxy = new Proxy({}, {
     get: (_, prop) => {
-        // Normalize to stable id so bracket keys with dots and Symbols become stable segments
-        propertyThatWasAccessed.push(normalizePropertyKey(prop));
+        // Direct assignment instead of push for speed
+        propertyPath[pathLength++] = normalizeKey(prop);
         return proxy;
     },
 });
 /**
- * Returns either the last part of a objects path  \
- * or dotted path if the fullPath flag is set to true.
+ * Returns the dot-separated property path captured from the selector expression.
  */
 export const nameof = (expression) => {
-    propertyThatWasAccessed.length = 0;
+    pathLength = 0;
     expression(proxy);
-    return propertyThatWasAccessed.join('.');
+    // Fast path for single property (most common case)
+    if (pathLength === 1)
+        return propertyPath[0];
+    // Fast path for 2-3 properties (very common)
+    if (pathLength === 2)
+        return propertyPath[0] + '.' + propertyPath[1];
+    if (pathLength === 3)
+        return propertyPath[0] + '.' + propertyPath[1] + '.' + propertyPath[2];
+    // General case: manual join for better performance than Array.join
+    let result = propertyPath[0];
+    for (let i = 1; i < pathLength; i++)
+        result += '.' + propertyPath[i];
+    return result;
 };
 /**
  * Returns a fresh array of path segments captured from the selector expression.
  * The returned array is a new copy to avoid external mutations affecting internals.
  */
 export const nameofSegments = (expression) => {
-    propertyThatWasAccessed.length = 0;
+    pathLength = 0;
     expression(proxy);
-    return propertyThatWasAccessed.slice();
+    // Fast paths for common cases
+    if (pathLength === 1)
+        return [propertyPath[0]];
+    if (pathLength === 2)
+        return [propertyPath[0], propertyPath[1]];
+    if (pathLength === 3)
+        return [propertyPath[0], propertyPath[1], propertyPath[2]];
+    // General case: manual copy for better performance
+    const result = new Array(pathLength);
+    for (let i = 0; i < pathLength; i++)
+        result[i] = propertyPath[i];
+    return result;
 };
 //# sourceMappingURL=nameof.js.map

package/dist/nameof.js.map

@@ -1 +1 @@
-{"version":3,"file":"nameof.js","sourceRoot":"","sources":["../src/nameof.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,qDAAqD;AACrD,MAAM,uBAAuB,GAAa,EAAE,CAAC;AAG7C,4CAA4C;AAC5C,MAAM,KAAK,GAAQ,IAAI,KAAK,CAAC,EAAS,EAAE;IACvC,GAAG,EAAE,CAA8B,CAAM,EAAE,IAAO,EAAE,EAAE;QACrD,sFAAsF;QACtF,uBAAuB,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzD,OAAO,KAAK,CAAC;IACd,CAAC;CACD,CAAC,CAAC;AAMH;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAU,UAAgC,EAAU,EAAE;IAC3E,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,UAAgC,EAAY,EAAE;IACrF,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,uBAAuB,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC,CAAC"}
+{"version":3,"file":"nameof.js","sourceRoot":"","sources":["../src/nameof.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,8CAA8C;AAC9C,MAAM,YAAY,GAAa,EAAE,CAAC;AAElC,qDAAqD;AACrD,IAAI,UAAU,GAAG,CAAC,CAAC;AAGnB,sDAAsD;AACtD,MAAM,YAAY,GAAG,CAAC,IAAiB,EAAU,EAAE,CAClD,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAe,CAAC;AAGjE,+CAA+C;AAC/C,MAAM,KAAK,GAAQ,IAAI,KAAK,CAAC,EAAS,EAAE;IACvC,GAAG,EAAE,CAAC,CAAM,EAAE,IAAiB,EAAE,EAAE;QAClC,8CAA8C;QAC9C,YAAY,CAAC,UAAU,EAAE,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAEhD,OAAO,KAAK,CAAC;IACd,CAAC;CACD,CAAC,CAAC;AAMH;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAU,UAAgC,EAAU,EAAE;IAC3E,UAAU,GAAG,CAAC,CAAC;IACf,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,mDAAmD;IACnD,IAAI,UAAU,KAAK,CAAC;QACnB,OAAO,YAAY,CAAC,CAAC,CAAE,CAAC;IAEzB,6CAA6C;IAC7C,IAAI,UAAU,KAAK,CAAC;QACnB,OAAO,YAAY,CAAC,CAAC,CAAE,GAAG,GAAG,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IAClD,IAAI,UAAU,KAAK,CAAC;QACnB,OAAO,YAAY,CAAC,CAAC,CAAE,GAAG,GAAG,GAAG,YAAY,CAAC,CAAC,CAAE,GAAG,GAAG,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IAE3E,mEAAmE;IACnE,IAAI,MAAM,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE;QAClC,MAAM,IAAI,GAAG,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IAElC,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,UAAgC,EAAY,EAAE;IACrF,UAAU,GAAG,CAAC,CAAC;IACf,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,8BAA8B;IAC9B,IAAI,UAAU,KAAK,CAAC;QACnB,OAAO,CAAE,YAAY,CAAC,CAAC,CAAE,CAAE,CAAC;IAE7B,IAAI,UAAU,KAAK,CAAC;QACnB,OAAO,CAAE,YAAY,CAAC,CAAC,CAAE,EAAE,YAAY,CAAC,CAAC,CAAE,CAAE,CAAC;IAE/C,IAAI,UAAU,KAAK,CAAC;QACnB,OAAO,CAAE,YAAY,CAAC,CAAC,CAAE,EAAE,YAAY,CAAC,CAAC,CAAE,EAAE,YAAY,CAAC,CAAC,CAAE,CAAE,CAAC;IAEjE,mDAAmD;IACnD,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE;QAClC,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IAG9B,OAAO,MAAM,CAAC;AACf,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcmantle/chronicle",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "A library for managing changes over time with undo/redo functionality",
   "repository": {
     "type": "git",

package/src/nameof.ts

@@ -1,15 +1,23 @@
-import { normalizePropertyKey } from './symbol-id.ts';
+import { getSymbolId } from './symbol-id.ts';
 
 
-// nameof property path is stored here for retrieval.
-const propertyThatWasAccessed: string[] = [];
+// Pre-allocated array to minimize allocations
+const propertyPath: string[] = [];
 
+// Fast path length tracking to avoid .length lookups
+let pathLength = 0;
 
-// Proxy objects to store the property path.
+
+// Inline property key normalization for maximum speed
+const normalizeKey = (prop: PropertyKey): string =>
+	typeof prop === 'symbol' ? getSymbolId(prop) : (prop as string);
+
+
+// Highly optimized proxy with minimal overhead
 const proxy: any = new Proxy({} as any, {
-	get: <const C extends PropertyKey>(_: any, prop: C) => {
-		// Normalize to stable id so bracket keys with dots and Symbols become stable segments
-		propertyThatWasAccessed.push(normalizePropertyKey(prop));
+	get: (_: any, prop: PropertyKey) => {
+		// Direct assignment instead of push for speed
+		propertyPath[pathLength++] = normalizeKey(prop);
 
 		return proxy;
 	},
@@ -20,14 +28,28 @@ export type Nameof<T> = (m: T extends object ? T : any) => any;
 
 
 /**
- * Returns either the last part of a objects path  \
- * or dotted path if the fullPath flag is set to true.
+ * Returns the dot-separated property path captured from the selector expression.
  */
 export const nameof = <const T>(expression: (instance: T) => any): string => {
-	propertyThatWasAccessed.length = 0;
+	pathLength = 0;
 	expression(proxy);
 
-	return propertyThatWasAccessed.join('.');
+	// Fast path for single property (most common case)
+	if (pathLength === 1)
+		return propertyPath[0]!;
+
+	// Fast path for 2-3 properties (very common)
+	if (pathLength === 2)
+		return propertyPath[0]! + '.' + propertyPath[1]!;
+	if (pathLength === 3)
+		return propertyPath[0]! + '.' + propertyPath[1]! + '.' + propertyPath[2]!;
+
+	// General case: manual join for better performance than Array.join
+	let result = propertyPath[0]!;
+	for (let i = 1; i < pathLength; i++)
+		result += '.' + propertyPath[i]!;
+
+	return result;
 };
 
 /**
@@ -35,8 +57,24 @@ export const nameof = <const T>(expression: (instance: T) => any): string => {
  * The returned array is a new copy to avoid external mutations affecting internals.
  */
 export const nameofSegments = <const T>(expression: (instance: T) => any): string[] => {
-	propertyThatWasAccessed.length = 0;
+	pathLength = 0;
 	expression(proxy);
 
-	return propertyThatWasAccessed.slice();
+	// Fast paths for common cases
+	if (pathLength === 1)
+		return [ propertyPath[0]! ];
+
+	if (pathLength === 2)
+		return [ propertyPath[0]!, propertyPath[1]! ];
+
+	if (pathLength === 3)
+		return [ propertyPath[0]!, propertyPath[1]!, propertyPath[2]! ];
+
+	// General case: manual copy for better performance
+	const result = new Array(pathLength);
+	for (let i = 0; i < pathLength; i++)
+		result[i] = propertyPath[i]!;
+
+
+	return result;
 };