TypeScript Library Starter

Rollup-based TypeScript library starter producing ESM, CJS, and UMD bundles. Uses pnpm, ESLint, Prettier, and Vitest.

Scripts

- pnpm build – clean and bundle outputs to dist/ (ESM/CJS/UMD + .d.ts).
- pnpm dev – watch and rebuild on changes.
- pnpm lint – run ESLint on source and tests.
- pnpm test – run unit tests with Vitest.
- pnpm typecheck – TypeScript type checking without emit.
- pnpm format – format with Prettier.

Entry Points

- ESM: dist/index.mjs
- CJS: dist/index.cjs
- UMD: dist/index.umd.js (global name TsLib)
- Types: dist/index.d.ts

Usage

Signal-backed forms with @preact/signals-core:
This is a TypeScript form library powered by @preact/signals-core with a deterministic dependency graph and Rollup bundling (ESM/CJS/UMD). A Preact example app demonstrates usage.

### Engine Determinism & Phase Ledger
- Overview: see DETERMINISM.md
- Phase status & locked semantics: see PHASE_LEDGER.md
- Public API stability and exports: see PUBLIC_API.md
``ts
const age = new Field('age', 0, [(value) => (value > 0 ? null : 'Must be positive')]);
const form = new Form({ name, age });

const result = await form.submit(async (values) => {
// handle validated values
console.log(values.name, values.age);
});

if (!result.ok) {
console.log(form.errors.value);
}
`

Utility exports remain available:

`ts
import { greet, sum } from 'ts-lib';

greet('Ada');
sum([1, 2, 3]);
`

Development Notes

- Node >= 18.17
- Package manager: pnpm (see packageManager field)
- Source lives in src/, tests in test/`.