feat/tschema improvements

[solidsnakedev]

No description provided.

[Copilot]

Pull request overview

This PR enhances the TSchema module with new Literal options for better Union control, simplifies implementation by removing redundant code, and adds comprehensive test coverage.

Key Changes

• Added LiteralOptions interface with index and flatInUnion options for custom positioning and flattening behavior in unions
• Removed redundant OneLiteral function, consolidating into the main Literal function with overloaded signatures
• Optimized collision detection algorithm from O(n²) to O(n) using Map-based tracking
• Added 7 new round-trip tests covering UndefinedOr, custom indices, flatFields, Variant, TaggedStruct, and flatInUnion combinations

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
packages/evolution/src/core/TSchema.ts	Core implementation changes: simplified helper functions, added Literal options, removed OneLiteral, optimized Union collision detection, and improved error handling
packages/evolution/test/TSchema.test.ts	Added 7 new comprehensive round-trip tests for previously untested features including UndefinedOr, custom indices, flatFields, Variant, and TaggedStruct
packages/evolution/docs/modules/core/TSchema.ts.md	Updated documentation to reflect OneLiteral removal, added LiteralOptions interface documentation, and updated TaggedStruct signature
.changeset/beige-donuts-wish.md	Detailed changeset documenting new features, code simplifications, optimizations, and new test coverage

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The actualStr calculation doesn't handle bigints correctly. When actual is a bigint, typeof actual === "object" is false, so it will try JSON.stringify(actual), which throws an error because JSON.stringify cannot serialize bigints.

Consider using the same pattern as getTypeName to handle all types consistently:

const actualStr = typeof actual === "bigint" ? String(actual) : typeof actual === "object" ? String(actual) : JSON.stringify(actual)

Suggested change

	const actualStr = typeof actual === "object" ? String(actual) : JSON.stringify(actual)
	const actualStr = typeof actual === "bigint"
	? String(actual)
	: typeof actual === "object"
	? String(actual)
	: JSON.stringify(actual)