Add TypeScript type definitions

[konard]

Summary

This PR adds comprehensive TypeScript type definitions to the links-notation JavaScript package, enabling better developer experience for TypeScript users.

Changes

Core Implementation

• ✅ Added js/index.d.ts - Complete TypeScript type definitions for all exported classes and functions
  • Link class with all methods and properties
  • Parser class with configurable options
  • FormatOptions and FormatConfig classes for formatting configuration
  • LinksGroup class for grouping related links
  • formatLinks function for bulk formatting
  • Full JSDoc comments for all types, interfaces, and methods

Configuration

• ✅ Updated js/package.json
  • Added "types": "index.d.ts" field to reference type definitions
  • Added TypeScript as devDependency for type-checking during development

Documentation & Examples

• ✅ Created js/examples/typescript-example.ts - Comprehensive example demonstrating:

  • Basic parsing with type safety
  • Creating links programmatically
  • Using FormatOptions and FormatConfig
  • All major API features with type annotations

• ✅ Updated js/README.md - Added TypeScript usage section with:

  • TypeScript support overview
  • Basic TypeScript examples
  • Advanced TypeScript usage patterns

Testing & Validation

• ✅ Added js/tsconfig.json - TypeScript configuration for development
• ✅ All type definitions validated with TypeScript compiler (no errors)
• ✅ All existing tests pass (188/188)
• ✅ Code formatted with Prettier
• ✅ ESLint checks pass

Benefits

This implementation provides TypeScript users with:

• IntelliSense/Autocomplete: Full editor support for all APIs
• Compile-time Type Checking: Catch errors before runtime
• Better Documentation: Type information serves as inline documentation
• Type Safety: Prevents common mistakes like passing wrong parameter types

Example Usage

import { Parser, Link, FormatOptions } from 'links-notation';

// TypeScript provides full type checking and autocomplete
const parser = new Parser({
  maxInputSize: 10 * 1024 * 1024,
  maxDepth: 1000
});

const links: Link[] = parser.parse('(source: type target)');

const formatOptions = new FormatOptions({
  lessParentheses: true,
  maxLineLength: 80,
  indentLongLines: true,
});

const formatted: string = links[0].format(formatOptions);

Testing

All tests continue to pass, and the type definitions have been validated:

$ bun test
✓ 188 tests passed (510 assertions)

$ npx tsc --noEmit
✓ No type errors found

$ bun run lint
✓ No linting issues

Fixes

Fixes #198

---

Ready for review! This implementation provides complete TypeScript support while maintaining full backward compatibility with existing JavaScript code.

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $1.904384 USD
• Calculated by Anthropic: $1.113094 USD
• Difference: $-0.791290 (-41.55%)
  📎 Log file uploaded as Gist (385KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.