feat: add AGENTS.md and llms.txt for AI discoverability #45

	name: Test TypeScript Versions

	on:
	push:
	branches: [master, 'feat/', 'fix/', 'ci/**']
	pull_request:

	jobs:
	test:
	runs-on: ubuntu-latest
	strategy:
	fail-fast: false
	matrix:
	# 4.9 is the baseline pinned in devDependencies.
	# 4.5/4.7 omitted — transitive @types/node uses accessor syntax requiring TS 4.9+,
	# causing parse errors that skipLibCheck cannot suppress.
	typescript: ['4.9', '5.0', '5.4', 'latest']

	name: TypeScript ${{ matrix.typescript }}

	steps:
	- uses: actions/checkout@v4

	- name: Setup Node
	uses: actions/setup-node@v4
	with:
	node-version: 20.x
	cache: 'yarn'

	- name: Install dependencies
	run: yarn install --frozen-lockfile

	- name: Swap to TypeScript ${{ matrix.typescript }}
	run: yarn add --dev typescript@${{ matrix.typescript }}

	# Type-check the library source only (tsconfig.lib.json excludes __tests__).
	# Test files need @types/jest globals which changed resolution in TS 6+,
	# so we validate the public API surface in isolation.
	# TS 6.x deprecated moduleResolution:node — pass ignoreDeprecations via CLI
	# (it's a TS 5.0+ option so cannot live in tsconfig.json for our 4.9 matrix job).
	- name: Type check library source
	run: \|
	TS_MAJOR=$(npx tsc --version \| grep -oE '[0-9]+' \| head -1)
	if [ "$TS_MAJOR" -ge 6 ]; then
	npx tsc -p tsconfig.lib.json --noEmit --ignoreDeprecations 6.0
	else
	npx tsc -p tsconfig.lib.json --noEmit
	fi

Provide feedback