ContractSpec docs

OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

i18n factory snapshot & hydration

Additive snapshot/serialization/hydration surface for the createI18nFactory stack.

field.key.label
i18n factory snapshot & hydration
field.version.label
field.type.label
field.title.label
i18n factory snapshot & hydration
field.description.label

Additive snapshot/serialization/hydration surface for the createI18nFactory stack.

field.tags.label
i18n,translations,ssr,hydration
field.owners.label
field.stability.label
public

The canonical, additive (behavior-compatible) snapshot/hydration surface on the `createI18nFactory` stack.

`buildI18nFactorySnapshot` produces a **locale-scoped** snapshot containing

only the catalogs needed to reproduce identical `t()` results for the locale (the locale plus its declared fallback chain).

`createI18nFactoryHydrationPayload` wraps a snapshot in a versioned envelope

(`kind` = `contractspec.i18n-factory.hydration`, `version` = `1`) for SSR -> client transport.

`parseI18nFactoryHydrationPayload` validates and re-clones the payload.

Reconstruct a factory from a snapshot or payload with `createI18nFactoryFromSnapshot` / `createI18nFactoryFromHydrationPayload` (see the `i18n-factory` module).

Compatibility classification: **ADDITIVE**. No existing exported symbol or resolution behavior changes.