# lingo

> Make forms easier, LLM tools safer. Zero-dependency TypeScript library that parses natural-language quantities, units, dates, and ranges into canonical SI-anchored values; converts, validates, formats, and humanizes. Entries: `@pascal-app/lingo`, `@pascal-app/lingo/date`, `@pascal-app/lingo/dom`, `@pascal-app/lingo/element`, `@pascal-app/lingo/react`, `@pascal-app/lingo/ai`, `@pascal-app/lingo/mcp`, `@pascal-app/lingo/describe`, `@pascal-app/lingo/catalog`, `@pascal-app/lingo/complete`, `@pascal-app/lingo/schema`, `@pascal-app/lingo/locales/{en,en-gb,es,fr,pt,zh,ja}`, `@pascal-app/lingo/core`.

Agent fetch order: read this index first, then fetch section markdown at `/docs/<section>.md` for the topic you need, or `/llms-full.txt` for the complete narrative. For offline or compressed reference, fetch `/llms-small.txt` (npm-shipped package reference). Keep user measurements as strings in tool schemas; call lingo to convert, validate, surface spans, and handle ambiguity.

## Documentation sets

- [Complete documentation](https://lingo.pascal.app/llms-full.txt): Full `/docs` page as markdown — installation through API reference.
- [Compressed reference](https://lingo.pascal.app/llms-small.txt): Self-contained API reference shipped in the npm package.
- [Legacy full markdown](https://lingo.pascal.app/llms.md): Same content as llms-full.txt; prefer `/llms-full.txt` or per-section `.md` URLs.

## Start

- [Introduction](https://lingo.pascal.app/docs/introduction.md): What lingo is for and where to start.
- [Install](https://lingo.pascal.app/docs/installation.md): Install the package and pick an entry.
- [Parse](https://lingo.pascal.app/docs/parse.md): Turn text into a canonical, validated value.
- [Strictness](https://lingo.pascal.app/docs/strictness.md): Forgiving, confirm, or strict — plus accept, tolerance, escalate.

## Forms

Make forms easier

- [Inputs](https://lingo.pascal.app/docs/forms.md): Turn any input into a natural-language field.
- [Frameworks](https://lingo.pascal.app/docs/integrations.md): One field across React Hook Form, TanStack, Vue, and more.
- [Unit fields](https://lingo.pascal.app/docs/forms-ux.md): Collapse one value plus one unit picker into one field.

## AI & agents

Make LLM tools safer

- [Tool fields](https://lingo.pascal.app/docs/for-ai.md): Validate model-emitted values at the tool boundary.
- [MCP tools](https://lingo.pascal.app/docs/mcp.md): Turn a field shape into a full MCP tool descriptor.
- [One schema](https://lingo.pascal.app/docs/one-schema.md): One lingoObject for a tool argument and a human form.

## Values & units

The engine

- [Convert & format](https://lingo.pascal.app/docs/convert.md): Convert between units and render values back.
- [Currency](https://lingo.pascal.app/docs/currency.md): Parse symbols and codes; convert with your own rates.
- [Dates & durations](https://lingo.pascal.app/docs/dates.md): Relative dates against an explicit now, two-way.
- [Locales](https://lingo.pascal.app/docs/locales.md): Load tree-shakeable language packs for parsing.
- [Catalog](https://lingo.pascal.app/docs/coverage.md): Browse kinds, units, aliases, and fuzzy vocab.

## Reference

- [Performance](https://lingo.pascal.app/docs/performance.md): Read local benchmark results in product terms.
- [Extend](https://lingo.pascal.app/docs/extend.md): Custom kinds and units, instances, core, and message packs.
- [Resource views](https://lingo.pascal.app/docs/resource-views.md): Self-explaining output for logs, docs, and tools.
- [API](https://lingo.pascal.app/docs/api.md): Functions, options, issue codes, and type safety.

## Schema & wire types

- [JSON Schema](https://lingo.pascal.app/schema/lingo.schema.json): Draft 2020-12 of the v3 wire types.
- [OpenAPI 3.1](https://lingo.pascal.app/schema/lingo.openapi.json): OpenAPI document for the wire shapes.
- [Schema dictionary](https://lingo.pascal.app/schema/dictionary.md): Human-readable field glossary for wire types.

## Optional

- [Zod adapter](https://lingo.pascal.app/schema/adapters/zod.ts): Generated Zod schema from the wire types.
- [Valibot adapter](https://lingo.pascal.app/schema/adapters/valibot.ts): Generated Valibot schema.
- [TypeBox adapter](https://lingo.pascal.app/schema/adapters/typebox.ts): Generated TypeBox schema.
- [ArkType adapter](https://lingo.pascal.app/schema/adapters/arktype.ts): Generated ArkType schema.
- [Effect adapter](https://lingo.pascal.app/schema/adapters/effect.ts): Generated Effect Schema.
- [README](https://github.com/pascalorg/lingo/tree/main/packages/lingo#readme): Package overview and recipes on GitHub.