@stonecrop/stonecrop 0.13.3 → 0.13.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/stonecrop",
-  "version": "0.13.3",
+  "version": "0.13.5",
   "license": "MIT",
   "type": "module",
   "author": {
@@ -34,7 +34,7 @@
     "pinia-shared-state": "^1.0.1",
     "pinia-xstate": "^3.0.0",
     "xstate": "^5.25.0",
-    "@stonecrop/schema": "0.13.3"
+    "@stonecrop/schema": "0.13.5"
   },
   "peerDependencies": {
     "pinia": "^3.0.4",
@@ -42,27 +42,23 @@
     "vue-router": "^5.0.6"
   },
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
     "@microsoft/api-documenter": "^7.30.5",
     "@rushstack/heft": "^1.2.17",
     "@vitejs/plugin-vue": "^6.0.6",
     "@vitest/coverage-istanbul": "^4.1.5",
     "@vue/test-utils": "^2.4.10",
-    "eslint": "^10.3.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-vue": "^10.9.0",
-    "globals": "^17.6.0",
     "jsdom": "^29.1.1",
-    "typescript": "^6.0.3",
+    "oxlint": "1.67.0",
+    "oxlint-tsgolint": "0.23.0",
     "pinia": "^3.0.4",
-    "typescript-eslint": "^8.59.1",
-    "vue": "^3.5.33",
-    "vue-router": "^5.0.6",
+    "typescript": "^6.0.3",
     "vite": "^7.3.2",
     "vitest": "^4.1.5",
-    "@stonecrop/atable": "0.13.3",
-    "@stonecrop/aform": "0.13.3",
-    "stonecrop-rig": "0.7.0"
+    "vue": "^3.5.33",
+    "vue-router": "^5.0.6",
+    "@stonecrop/aform": "0.13.5",
+    "stonecrop-rig": "0.7.0",
+    "@stonecrop/atable": "0.13.5"
   },
   "description": "Schema-driven framework with XState workflows and HST state management",
   "publishConfig": {
@@ -75,7 +71,8 @@
     "_phase:build": "heft build && vite build && rushx docs",
     "build": "heft build && vite build && rushx docs",
     "docs": "bash ../common/scripts/run-docs.sh stonecrop",
-    "lint": "eslint .",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
     "preview": "vite preview",
     "test": "vitest run --coverage.enabled false",
     "test:watch": "vitest watch",

package/src/composables/lazy-link.ts

@@ -62,7 +62,7 @@ export function useLazyLink(doctype: Doctype, recordId: string, linkFieldname: s
 		try {
 			// Create function from serialized string and invoke it
 			// The function receives the stonecrop instance and path as parameters
-			// eslint-disable-next-line @typescript-eslint/no-implied-eval
+			// oxlint-disable-next-line @typescript-eslint/no-implied-eval
 			const fn = new Function(
 				'stonecrop',
 				'path',
@@ -71,7 +71,6 @@ export function useLazyLink(doctype: Doctype, recordId: string, linkFieldname: s
 				return (${handler})(stonecrop, path, hst)
 			`
 			)
-			// eslint-disable-next-line @typescript-eslint/no-unsafe-call
 			return await fn(stonecropInstance, getLinkPath(), hstStore)
 		} catch (err) {
 			throw new Error(`Custom handler failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err })

package/src/composables/stonecrop.ts

@@ -116,12 +116,12 @@ export function useStonecrop(options?: {
 	)
 
 	// Operation log methods
-	const undo = (hstStore: HSTNode): boolean => {
-		return stonecrop.value?.getOperationLogStore().undo(hstStore) ?? false
+	const undo = (hstNode: HSTNode): boolean => {
+		return stonecrop.value?.getOperationLogStore().undo(hstNode) ?? false
 	}
 
-	const redo = (hstStore: HSTNode): boolean => {
-		return stonecrop.value?.getOperationLogStore().redo(hstStore) ?? false
+	const redo = (hstNode: HSTNode): boolean => {
+		return stonecrop.value?.getOperationLogStore().redo(hstNode) ?? false
 	}
 
 	const startBatch = () => {
@@ -165,9 +165,9 @@ export function useStonecrop(options?: {
 		actionName: string,
 		recordIds?: string[],
 		result: 'success' | 'failure' | 'pending' = 'success',
-		error?: string
+		errorMessage?: string
 	): string => {
-		return stonecrop.value?.getOperationLogStore().logAction(doctype, actionName, recordIds, result, error) ?? ''
+		return stonecrop.value?.getOperationLogStore().logAction(doctype, actionName, recordIds, result, errorMessage) ?? ''
 	}
 
 	const configure = (config: Partial<OperationLogConfig>) => {
@@ -462,12 +462,12 @@ export function useStonecrop(options?: {
 		path: string,
 		doctype: Doctype,
 		recordId: string,
-		options?: { includeNested?: boolean | string[] }
+		fetchOptions?: { includeNested?: boolean | string[] }
 	): Promise<void> => {
 		if (!stonecrop.value) {
 			throw new Error('Stonecrop instance not available')
 		}
-		return stonecrop.value.fetchNestedData(path, doctype, recordId, options)
+		return stonecrop.value.fetchNestedData(path, doctype, recordId, fetchOptions)
 	}
 
 	/**
@@ -613,7 +613,7 @@ function setupDeepReactivity(
  * Update nested object with dot-notation path
  */
 function updateNestedObject(obj: any, path: string[], value: any): void {
-	let current = obj as Record<string, any>
+	let current: Record<string, any> = obj
 
 	for (let i = 0; i < path.length - 1; i++) {
 		const key = path[i]
@@ -622,7 +622,7 @@ function updateNestedObject(obj: any, path: string[], value: any): void {
 			current[key] = isNaN(Number(path[i + 1])) ? {} : []
 		}
 
-		current = current[key] as Record<string, any>
+		current = current[key]
 	}
 
 	const finalKey = path[path.length - 1]

package/src/doctype.ts

@@ -190,6 +190,7 @@ export default class Doctype {
 			const states = workflow.states
 			if (!states.includes(currentState)) return []
 
+			// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Array.isArray(workflow.states) confirms WorkflowMeta format above
 			const actions = (workflow as WorkflowMeta).actions
 			if (!actions) return []
 
@@ -246,6 +247,7 @@ export default class Doctype {
 		const workflow = this.workflow
 		if (!workflow || !Array.isArray(workflow.states)) return undefined
 
+		// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Array.isArray(workflow.states) confirms WorkflowMeta format above
 		const actions = (workflow as WorkflowMeta).actions
 		return actions?.[actionName]
 	}

package/src/field-triggers.ts

@@ -45,6 +45,7 @@ export class FieldTriggerEngine {
 			enableRollback: options.enableRollback ?? true,
 			errorHandler: options.errorHandler,
 		}
+		return this
 	}
 
 	/**
@@ -111,6 +112,7 @@ export class FieldTriggerEngine {
 
 		// Convert from different Map types to regular Map
 		// Check for Immutable.js Map first (has entrySeq method)
+		// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Immutable.js interop: runtime duck-type check follows
 		const immutableActions = actions as ImmutableMap<string, string[]>
 		if (typeof immutableActions.entrySeq === 'function') {
 			// Immutable Map
@@ -125,6 +127,7 @@ export class FieldTriggerEngine {
 		} else if (actions && typeof actions === 'object') {
 			// Plain object
 			Object.entries(actions).forEach(([key, value]) => {
+				// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Object.entries value type is unknown at runtime; guarded by typeof object check above
 				this.categorizeAction(key, value as string[], actionMap, transitionMap)
 			})
 		}
@@ -199,9 +202,10 @@ export class FieldTriggerEngine {
 			snapshot = this.captureSnapshot(context)
 		}
 
-		// Execute actions sequentially
+		// Execute actions sequentially — each action may depend on state set by the previous; stop-on-error semantics require sequential execution
 		for (const actionName of triggers) {
 			try {
+				// oxlint-disable-next-line eslint/no-await-in-loop -- intentionally sequential; actions are order-dependent and stop on first failure
 				const actionResult = await this.executeAction(actionName, context, options.timeout)
 				actionResults.push(actionResult)
 
@@ -229,7 +233,6 @@ export class FieldTriggerEngine {
 				this.restoreSnapshot(context, snapshot)
 				rolledBack = true
 			} catch (rollbackError) {
-				// eslint-disable-next-line no-console
 				console.error('[FieldTriggers] Rollback failed:', rollbackError)
 			}
 		}
@@ -245,7 +248,6 @@ export class FieldTriggerEngine {
 						this.options.errorHandler(failedResult.error, context, failedResult.action)
 					}
 				} catch (handlerError) {
-					// eslint-disable-next-line no-console
 					console.error('[FieldTriggers] Error in global error handler:', handlerError)
 				}
 			}
@@ -283,9 +285,10 @@ export class FieldTriggerEngine {
 
 		const results: TransitionExecutionResult[] = []
 
-		// Execute transition actions sequentially
+		// Execute transition actions sequentially — transitions are state-machine steps; order and stop-on-error are required
 		for (const actionName of transitionActions) {
 			try {
+				// oxlint-disable-next-line eslint/no-await-in-loop -- intentionally sequential; transition actions are order-dependent and stop on first failure
 				const actionResult = await this.executeTransitionAction(actionName, context, options.timeout)
 				results.push(actionResult)
 
@@ -314,10 +317,10 @@ export class FieldTriggerEngine {
 				try {
 					// Call with FieldChangeContext (base context type)
 					if (failedResult.error) {
+						// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- action result carries string name; FieldAction cast required by errorHandler signature
 						this.options.errorHandler(failedResult.error, context, failedResult.action as unknown as FieldAction)
 					}
 				} catch (handlerError) {
-					// eslint-disable-next-line no-console
 					console.error('[FieldTriggers] Error in global error handler:', handlerError)
 				}
 			}
@@ -365,6 +368,7 @@ export class FieldTriggerEngine {
 				throw new Error(`Transition action "${actionName}" not found in registry`)
 			}
 
+			// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- actionFn may be FieldActionFunction set from globalActions fallback; polymorphic function type
 			await this.executeWithTimeout(actionFn as FieldActionFunction, context, actionTimeout)
 			const executionTime = performance.now() - startTime
 
@@ -515,7 +519,7 @@ export class FieldTriggerEngine {
 			Promise.resolve(fn(context))
 				.then(result => {
 					clearTimeout(timeoutId)
-					resolve(result)
+					return resolve(result)
 				})
 				.catch(error => {
 					clearTimeout(timeoutId)
@@ -548,7 +552,6 @@ export class FieldTriggerEngine {
 			return JSON.parse(JSON.stringify(recordData))
 		} catch (error) {
 			if (this.options.debug) {
-				// eslint-disable-next-line no-console
 				console.warn('[FieldTriggers] Failed to capture snapshot:', error)
 			}
 			return undefined
@@ -572,11 +575,10 @@ export class FieldTriggerEngine {
 			context.store.set(recordPath, snapshot)
 
 			if (this.options.debug) {
-				// eslint-disable-next-line no-console
+				// oxlint-disable-next-line no-console
 				console.log(`[FieldTriggers] Rolled back ${recordPath} to previous state`)
 			}
 		} catch (error) {
-			// eslint-disable-next-line no-console
 			console.error('[FieldTriggers] Failed to restore snapshot:', error)
 			throw error
 		}

package/src/plugins/index.ts

@@ -93,7 +93,6 @@ const plugin: Plugin = {
 			}
 		} catch (error) {
 			// Pinia not available - operation log won't work, but app should still function
-			// eslint-disable-next-line no-console
 			console.warn('Pinia not available - operation log features will be disabled:', error)
 		}
 

package/src/registry.ts

@@ -67,6 +67,7 @@ export default class Registry {
 		Registry._root = this
 		this.router = router
 		this.getMeta = getMeta
+		return this
 	}
 
 	/**
@@ -161,11 +162,12 @@ export default class Registry {
 			if ('fieldtype' in field && field.fieldtype === 'Link') {
 				const link = linksByFieldname.get(field.fieldname)
 				if (!link) {
-					const doctype =
+					// oxlint-disable typescript/no-unsafe-type-assertion -- SchemaTypes union narrowed to FieldMeta by fieldtype === 'Link' check; options may not exist on all members
+					const linkDoctype =
 						typeof (field as FieldMeta).options === 'string' ? ((field as FieldMeta).options as string) : undefined
+					// oxlint-enable typescript/no-unsafe-type-assertion
 
-					if (doctype === undefined) {
-						// eslint-disable-next-line no-console
+					if (linkDoctype === undefined) {
 						console.warn(
 							`[Stonecrop] Link field "${field.fieldname}" has no \`options\` or corresponding \`links\` declaration. ` +
 								`AFormLink will be created without a \`doctype\` prop, so navigation will not work. ` +
@@ -182,7 +184,7 @@ export default class Registry {
 					resolvedFields.push({
 						...fieldRest,
 						component: fieldRest.component || 'AFormLink',
-						...(doctype !== undefined ? { doctype } : {}),
+						...(linkDoctype !== undefined ? { doctype: linkDoctype } : {}),
 					})
 
 					continue
@@ -425,10 +427,11 @@ export default class Registry {
 		const doctype = this.registry[doctypeSlug]
 		if (!doctype?.links) return []
 
-		return Object.entries(doctype.links).map(([fieldname, link]) => ({
-			...link,
-			fieldname,
-		}))
+		return Object.entries(doctype.links).map(([fieldname, link]) =>
+			Object.assign({}, link, {
+				fieldname,
+			})
+		)
 	}
 
 	/**

package/src/schema-validator.ts

@@ -80,6 +80,7 @@ export class SchemaValidator {
 		// Validate action registration
 		if (this.options.validateActions && actions) {
 			const actionsMap = actions instanceof Map ? actions : actions.toObject()
+			// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- toObject() returns plain object; runtime-safe cast for Map<string, string[]>
 			issues.push(...this.validateActionRegistration(doctype, actionsMap as Record<string, string[]>))
 		}
 
@@ -130,10 +131,13 @@ export class SchemaValidator {
 
 			// Validate nested schemas (recursively)
 			if ('schema' in field) {
+				// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- 'schema' in field guard confirms property exists; SchemaTypes union narrowed at runtime
 				const nestedSchema = (field as { schema: unknown }).schema
+				// oxlint-disable typescript/no-unsafe-type-assertion -- Immutable List or plain array; toArray() returns SchemaTypes elements
 				const nestedArray = (
 					Array.isArray(nestedSchema) ? nestedSchema : (nestedSchema as { toArray?: () => unknown[] }).toArray?.() || []
 				) as SchemaTypes[]
+				// oxlint-enable typescript/no-unsafe-type-assertion
 				issues.push(...this.validateRequiredProperties(doctype, nestedArray))
 			}
 		}
@@ -149,6 +153,7 @@ export class SchemaValidator {
 		const issues: ValidationIssue[] = []
 
 		for (const field of schema) {
+			// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- 'fieldtype' in field guard confirms property exists; accessing unknown-typed fieldtype safely
 			const fieldtype = 'fieldtype' in field ? (field as { fieldtype: unknown }).fieldtype : undefined
 
 			// Check Link fields
@@ -194,10 +199,13 @@ export class SchemaValidator {
 
 			// Recursively check nested schemas
 			if ('schema' in field) {
+				// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- 'schema' in field guard confirms property exists; SchemaTypes union narrowed at runtime
 				const nestedSchema = (field as { schema: unknown }).schema
+				// oxlint-disable typescript/no-unsafe-type-assertion -- Immutable List or plain array; toArray() returns SchemaTypes elements
 				const nestedArray = (
 					Array.isArray(nestedSchema) ? nestedSchema : (nestedSchema as { toArray?: () => unknown[] }).toArray?.() || []
 				) as SchemaTypes[]
+				// oxlint-enable typescript/no-unsafe-type-assertion
 				issues.push(...this.validateLinkFields(doctype, nestedArray, registry))
 			}
 		}
@@ -371,6 +379,7 @@ export class SchemaValidator {
 					if (typeof transition === 'string') {
 						reachableStates.add(transition)
 					} else if (transition && typeof transition === 'object') {
+						// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- 'target' in transition guard confirms property; accessing unknown-typed target safely
 						const target = 'target' in transition ? (transition as { target: unknown }).target : undefined
 						if (typeof target === 'string') {
 							reachableStates.add(target)
@@ -425,6 +434,7 @@ export class SchemaValidator {
 			// Check each action name
 			for (const actionName of actionNames) {
 				// Check if action is registered globally
+				// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- introspecting FieldTriggerEngine private fields for validation; no public API for this check
 				const engine = triggerEngine as unknown as {
 					globalActions?: Map<string, unknown>
 					globalTransitionActions?: Map<string, unknown>

package/src/stonecrop.ts

@@ -56,6 +56,7 @@ export class Stonecrop {
 		// Initialize HST store with auto-sync to Registry
 		this.initializeHSTStore()
 		this.setupRegistrySync()
+		return this
 	}
 
 	/**
@@ -207,7 +208,7 @@ export class Stonecrop {
 		const slug = typeof doctype === 'string' ? doctype : doctype.slug
 		this.ensureDoctypeExists(slug)
 
-		const doctypeNode = this.hstStore.get(slug) as Record<string, any>
+		const doctypeNode = this.hstStore.get(slug)
 		if (!doctypeNode || typeof doctypeNode !== 'object') {
 			return []
 		}
@@ -370,8 +371,10 @@ export class Stonecrop {
 
 		// Store each record in HST
 		records.forEach(record => {
-			if (record.id) {
-				this.addRecord(doctype, record.id as string, record)
+			if (typeof record.id === 'string' && record.id) {
+				this.addRecord(doctype, record.id, record)
+			} else if (typeof record.id === 'number') {
+				this.addRecord(doctype, String(record.id), record)
 			}
 		})
 	}
@@ -477,6 +480,7 @@ export class Stonecrop {
 		if (!meta?.workflow) return ''
 
 		const record = this.getRecordById(slug, recordId)
+		// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- HSTNode.get returns any; status is always string in workflow records
 		const status = record?.get('status') as string | undefined
 
 		// Handle both XState format and WorkflowMeta format
@@ -488,10 +492,12 @@ export class Stonecrop {
 			initialState = workflow.states[0] ?? ''
 		} else {
 			// XState format: states is an object, use initial or first key
+			// oxlint-disable typescript/no-unsafe-type-assertion -- XState MachineConfig has `initial` but type union doesn't expose it; runtime-guarded by typeof check
 			initialState =
 				typeof (workflow as { initial?: unknown }).initial === 'string'
 					? (workflow as { initial: string }).initial
 					: (Object.keys(workflow.states ?? {})[0] ?? '')
+			// oxlint-enable typescript/no-unsafe-type-assertion
 		}
 
 		return status || initialState
@@ -674,6 +680,7 @@ interface CodedError extends Error {
 }
 
 function createCodedError(message: string, code: string): CodedError {
+	// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- extending Error with code property; CodedError cast is the standard pattern for typed error objects
 	const error = new Error(message) as CodedError
 	error.code = code
 	return error

package/src/stores/hst.ts

@@ -54,14 +54,8 @@ interface PiniaStore {
 	[key: string]: any
 }
 
-// Interface for objects with property access
-interface PropertyAccessible {
-	[key: string]: any
-}
-
 // Extend global interfaces
 declare global {
-	// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 	interface Window extends RegistryGlobal {}
 	const global: RegistryGlobal | undefined
 }
@@ -94,7 +88,8 @@ class HST {
 		// In test environment, try different ways to access Registry
 		// First, try the global Registry if it exists
 		if (typeof globalThis !== 'undefined') {
-			const globalRegistry = (globalThis as RegistryGlobal).Registry?._root
+			// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Window interface extended with RegistryGlobal in declare global above; no other way to access globalThis properties
+			const globalRegistry = (globalThis as unknown as RegistryGlobal).Registry?._root
 			if (globalRegistry) {
 				return globalRegistry
 			}
@@ -129,7 +124,7 @@ class HST {
 	getDoctypeMeta(doctype: string) {
 		const registry = this.getRegistry()
 		if (registry && typeof registry === 'object' && 'registry' in registry) {
-			return (registry as { registry: Record<string, any> }).registry[doctype]
+			return registry.registry[doctype]
 		}
 		return undefined
 	}
@@ -199,7 +194,6 @@ class HSTProxy implements HSTNode {
 		// Get current value for change context
 		const fullPath = this.resolvePath(path)
 		if (fullPath === undefined) {
-			// eslint-disable-next-line no-console
 			console.warn('HST.set: resolved path is undefined, skipping operation')
 			return
 		}
@@ -445,7 +439,7 @@ class HSTProxy implements HSTNode {
 		}
 
 		// Plain object
-		return (obj as PropertyAccessible)[key]
+		return obj[key]
 	}
 
 	private setProperty(obj: any, key: string, value: any): void {
@@ -459,13 +453,13 @@ class HSTProxy implements HSTNode {
 			if (obj.$patch) {
 				obj.$patch({ [key]: value })
 			} else {
-				;(obj as PropertyAccessible)[key] = value
+				obj[key] = value
 			}
 			return
 		}
 
 		// Vue reactive or plain object
-		;(obj as PropertyAccessible)[key] = value
+		obj[key] = value
 	}
 
 	private async triggerFieldActions(fullPath: string, beforeValue: any, afterValue: any): Promise<void> {
@@ -524,19 +518,13 @@ class HSTProxy implements HSTNode {
 			// Silently handle trigger errors to not break the main flow
 			// In production, you might want to log this error
 			if (error instanceof Error) {
-				// eslint-disable-next-line no-console
 				console.warn('Field trigger error:', error.message)
 				// Optional: emit an event or call error handler
 			}
 		}
 	}
 	private isVueReactive(obj: any): obj is VueReactive {
-		return (
-			obj &&
-			typeof obj === 'object' &&
-			'__v_isReactive' in obj &&
-			(obj as { __v_isReactive: boolean }).__v_isReactive === true
-		)
+		return obj && typeof obj === 'object' && '__v_isReactive' in obj && obj.__v_isReactive === true
 	}
 
 	private isPiniaStore(obj: any): obj is PiniaStore {
@@ -548,9 +536,9 @@ class HSTProxy implements HSTNode {
 			return false
 		}
 
-		const hasGetMethod = 'get' in obj && typeof (obj as Record<string, unknown>).get === 'function'
-		const hasSetMethod = 'set' in obj && typeof (obj as Record<string, unknown>).set === 'function'
-		const hasHasMethod = 'has' in obj && typeof (obj as Record<string, unknown>).has === 'function'
+		const hasGetMethod = 'get' in obj && typeof obj.get === 'function'
+		const hasSetMethod = 'set' in obj && typeof obj.set === 'function'
+		const hasHasMethod = 'has' in obj && typeof obj.has === 'function'
 
 		const hasImmutableMarkers =
 			'__ownerID' in obj ||
@@ -565,14 +553,9 @@ class HSTProxy implements HSTNode {
 
 		let constructorName: string | undefined
 		try {
-			const objWithConstructor = obj as Record<string, unknown>
-			if (
-				'constructor' in objWithConstructor &&
-				objWithConstructor.constructor &&
-				typeof objWithConstructor.constructor === 'object' &&
-				'name' in objWithConstructor.constructor
-			) {
-				const nameValue = (objWithConstructor.constructor as { name: unknown }).name
+			if ('constructor' in obj && obj.constructor && typeof obj.constructor === 'object' && 'name' in obj.constructor) {
+				// oxlint-disable-next-line typescript/no-unsafe-type-assertion -- obj.constructor.name accessed after 'name' in check; obj is any throughout this method
+				const nameValue = (obj.constructor as { name: unknown }).name
 				constructorName = typeof nameValue === 'string' ? nameValue : undefined
 			}
 		} catch {