# @lssm-tech/lib.contracts-runtime-client-react

React runtime adapters for ContractSpec contracts

## Source and release context

- Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498`
- Repository: `lssm-tech/contractspec`
- Declared package version: `6.0.4`
- Package path: `packages/platform/delivery/contracts-runtime-client-react`
- Manifest path: `packages/platform/delivery/contracts-runtime-client-react/package.json`
- Manifest Git blob: `91178fa7e7ccc54605fa2556901bee820fb5fc48`
- Manifest origin: pinned GitHub manifest fetch
- Manual: [@lssm-tech/lib.contracts-runtime-client-react](https://lssm.co/docs/packages/lib.contracts-runtime-client-react/)
- Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/)

This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review.

Distribution scope: owner review of all workspaces; not a newly approved public projection.

- [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react)
- [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/package.json)
- [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/README.md)
- [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-client-react.txt)

## Package metadata

```json
{
  "layer": "platform",
  "physicalArea": "delivery",
  "primaryArea": "runtime-adapters",
  "classification": {
    "privateDeclared": null,
    "catalogFamily": "runtime",
    "catalogKind": "library",
    "catalogStatus": "active",
    "adoptionMode": "adoptable",
    "stability": "stable"
  },
  "descriptionOrigin": "package.json",
  "manifestComplete": true,
  "publicationPolicyApplied": false
}
```

Manifest private flag: not declared; publication is not verified.

Primary area: [Handlers, runtimes and transports](https://lssm.co/docs/areas/runtime-adapters/)

## Package guide

```json
{
  "status": "available",
  "sourcePath": "packages/platform/delivery/contracts-runtime-client-react/README.md",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/README.md",
  "blobSha": "98c913ba37cca28d313ac34b4e6836c7b57b8538",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "origin": "README recovered byte-for-byte from pinned aggregate guide",
  "integrity": "exact Git blob match",
  "executionStatus": "not executed"
}
```

The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations.

# @lssm-tech/lib.contracts-runtime-client-react

**React runtime adapters for ContractSpec contracts.**

Query/result primitives, feature and presentation declarations use their complete
Core owners. Locale and translation factory exports use TranslationRuntime;
feature registration retains the canonical Kernel `FeatureRegistry` class.
The form renderer uses the complete Core Form contracts and FormsRuntime runtime
helpers. Its tests retain the canonical DesignCatalog showcase singleton and
Core identity/layout helpers. PWA update checks consume the complete portable
Core `/pwa/types` contracts; all Source and test imports use their canonical owners.
Public entrypoints and React peer requirements are unchanged. The canonical registry and Forms runtime bindings
require Forms839a and the complete Kernel FeatureRegistry owner to be composed before qualification.

## What It Provides

- **Layer**: lib.
- **Consumers**: design-system, presentation-runtime-react, bundles.
- Related ContractSpec packages include `@lssm-tech/lib.contracts-spec`, `@lssm-tech/lib.schema`, `@lssm-tech/tool.bun`, `@lssm-tech/tool.typescript`.
- Related ContractSpec packages include `@lssm-tech/lib.contracts-spec`, `@lssm-tech/lib.schema`, `@lssm-tech/tool.bun`, `@lssm-tech/tool.typescript`.

## Installation

`npm install @lssm-tech/lib.contracts-runtime-client-react`

or

`bun add @lssm-tech/lib.contracts-runtime-client-react`

## Usage

Import the root entrypoint from `@lssm-tech/lib.contracts-runtime-client-react`, or choose a documented subpath when you only need one part of the package surface.

The form renderer supports the expanded FormSpec field set: readonly inputs, email, autocomplete, address, phone, date, time, datetime, semantic groups, repeated grouped arrays, grid layout hints, progressive `layout.flow` sections/steps, and text/textarea/email input groups. Drivers are expected to provide dedicated slots for rich widgets plus shadcn/Radix-style `Field*` and optional `InputGroup*` slots. Email fields render through the standard input slot with native email input behavior. When input-group slots are absent, text, email, and textarea fields fall back to plain controls.

Autocomplete fields support local filtering and resolver-backed search. Resolver
calls receive the current query, watched dependency values, field name, and an
`AbortSignal` through the existing resolver args object; stale responses are
ignored and selected remote options remain visible when later searches return a
different result set. Custom autocomplete driver slots can read optional
`loading`, `error`, `emptyText`, `loadingText`, and `errorText` props to expose
async state.

### PWA update checks

`usePwaUpdateChecker` from `@lssm-tech/lib.contracts-runtime-client-react/pwa-update-client` checks the `pwa.update.check` API, exposes required/blocking versus optional update state, supports polling, and delegates actual service worker activation to a host-provided `onApply` callback.

### LSSM OS durable-operation status

`useLssmOsOperationStatusV1` from
`@lssm-tech/lib.contracts-runtime-client-react/lssm-os-operation-status`
accepts the provider-neutral Runtime Node operation client port and returns its
`ui` projection unchanged. HTTP hosts may inject
`@lssm-tech/integration.lssm-os-operation-client`, but this React library has no
upward integration dependency. It polls only while the canonical operation is
nonterminal or its canonical error is retryable, aborts obsolete scopes, and
never derives a UI-specific status, receipt, or error mapping.

### Adaptive form support

`resolveAdaptiveFormExperience` from `@lssm-tech/lib.contracts-runtime-client-react/adaptive-form` maps `ResolvedAdaptiveExperience` into generic form guidance, density, control, and recovery defaults. It is a lightweight adapter for form renderers and vertical applications that want adaptive behavior without coupling forms to analytics or product-specific labels.

Use the result as an editable runtime recommendation. It should not override permissions, validation, authorization, or business rules.

### Query and mutation hooks

`useContractQuery(envelope, options?)` and `useContractMutation(options?)` are
**thin bindings over the in-house engine** in
`@lssm-tech/lib.contracts-runtime-core` [source link unresolved: `../../../libs/contracts-runtime-core`] — no
`@tanstack/*`. Wrap the surface in `ContractDataEngineProvider` with a
`createDataEngine({ transport })`, then:

- `useContractQuery` returns the canonical `QueryState<TData>` verbatim
  (`status`, `fetchStatus`, `data`, `error`, `cacheStatus`, `isStale`,
  `isOffline`, `conflict`, `versionToken`) plus `refetch` — so it flows straight
  into the I/O-free design-system `QueryState` components with zero adapter.
- `useContractMutation` returns the canonical mutation state (`status`, `data`,
  `problem`, `conflictOutcome`, `isPending`) plus `mutate(request, { optimistic? })`.

The engine owns the cache, request dedup, durable offline queue + replay, etag
conflict resolution, optimistic apply/rollback, and recoverable auth-expiry.
This package no longer ships cache-key/storage/policy helpers or a
`./query-client` subpath — they were removed in the data-fetching ecosystem
reset (the engine owns all of it). `parseContractResponse` (structuredContent-first
MCP/GraphQL decode) remains for non-engine response interpretation.

### Provider props for the local/offline mode

`ContractDataEngineProvider` accepts either a host-composed `engine` or a
`transport` from which it builds and owns the engine:

```tsx
<ContractDataEngineProvider
  transport={transport}
  mode={offlineEnabled ? "offline-capable" : "online-only"}
  offline={{ storage, reachability }}
>
  <App />
</ContractDataEngineProvider>
```


- `mode` takes `online-only`, `memory-cache` or `offline-capable`, or a policy
  resolved with `resolveLocalOfflinePolicy({ env, flag })`. Without `mode`,
  `offline.storage` selects `offline-capable` and no storage keeps `online-only`.
- `offline` is passed to the engine as its `advanced` options. Durable
  `offline.storage` and `offline.cacheStore` are forwarded only in
  `offline-capable` mode and dropped in `online-only` and `memory-cache`, so
  the same `offline` object works while `mode` toggles.
- The engine is rebuilt only when `transport`, the resolved mode, the forwarded
  `offline.storage` or `offline.reachability` changes, so inline `offline`
  objects are safe.
- The host reachability source is followed only while the provider is
  mounted, so a replaced engine stops draining the offline queue.
- On the explicit path, `engine` keeps working unchanged. An optional
  `transport` there only feeds realtime subscriptions.

### Realtime subscriptions

`useContractSubscription(tags, options?)` listens on the provider transport's
`subscribe()` seam, for example `createWebSocketTransport` from
`@lssm-tech/lib.contracts-runtime-core`. For each pushed event it marks the
matching cached reads stale and, when any matched, runs the engine's
`maintenance.revalidateStale()`, then calls `onInvalidate`. That pass refetches
every stale cache entry, not only the reads for the pushed tags. It returns
`{ supported, active, lastEvent, eventCount }`. A transport without
`subscribe()`, such as REST, reports `supported: false`. Reconnects,
backpressure and resync stay in the transport. Revalidation runs on the
engine's background path without a per-call `ctx`, and a failed invalidation
or revalidation goes to `onError`. An `online-only` engine has no cache to
revalidate, so in that mode use `onInvalidate` to refetch.

## Architecture

- `src/adaptive-form.ts` is part of the package's public or composition surface.
- `src/drivers` is part of the package's public or composition surface.
- `src/feature-render.ts` is part of the package's public or composition surface.
- `src/form-render.impl.tsx` is part of the package's public or composition surface.
- `src/form-render.ts` is part of the package's public or composition surface.
- `src/index.ts` is the root public barrel and package entrypoint.

## Public Entry Points

- Export `.` resolves through `./src/index.ts`.
- Export `./adaptive-form` resolves through `./src/adaptive-form.ts`.
- Export `./drivers/rn-reusables` resolves through `./src/drivers/rn-reusables.ts`.
- Export `./drivers/shadcn` resolves through `./src/drivers/shadcn.ts`.
- Export `./feature-render` resolves through `./src/feature-render.ts`.
- Export `./form-render` resolves through `./src/form-render.ts`.
- Export `./form-render.impl` resolves through `./src/form-render.impl.tsx`.
- Export `./pwa-update-client` resolves through `./src/pwa-update-client.tsx`.
- Export `./lssm-os-operation-status` resolves through `./src/lssm-os-operation-status.tsx`.
- Export `./subscriptions/use-contract-subscription` resolves through `./src/subscriptions/use-contract-subscription.tsx`.

## Local Commands

- `bun run dev` — contractspec-bun-build dev
- `bun run build` — contractspec-bun-build build
- `bun run lint` — bun run lint:fix
- `bun run lint:check` — biome check .
- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
- `bun run typecheck` — tsgo --noEmit
- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
- `bun run clean` — rm -rf dist
- `bun run build:bundle` — contractspec-bun-build transpile
- `bun run build:types` — contractspec-bun-build types
- `bun run prebuild` — contractspec-bun-build prebuild

## Recent Updates

- Replace eslint+prettier by biomejs to optimize speed.
- Add generic adaptive form experience helpers for runtime guidance defaults.

## Notes

- Driver interface must stay compatible with both shadcn and RN Reusables.
- Form rendering pipeline is a critical path; test thoroughly before changing.


### Source links needing reconciliation

- `../../../libs/contracts-runtime-core` — source path absent from pinned inventory: packages/libs/contracts-runtime-core.

## Declared capabilities

### Lib Contracts Runtime Client React

Capability ID: `package.lssm.tech.lib.contracts.runtime.client.react`

React runtime adapters for ContractSpec contracts

Use cases:

- Adopt react runtime adapters for contractspec contracts

Constraints:

```json
{
  "platforms": [
    "web",
    "server"
  ],
  "runtimes": [
    "browser",
    "bun",
    "node"
  ],
  "avoidWhen": [
    "The @lssm-tech/lib.contracts-runtime-client-react package constraints do not match the target runtime or platform."
  ],
  "requires": [
    "TypeScript"
  ]
}
```

Other capability declarations:

```json
{
  "status": "active",
  "aliases": [
    "lib",
    "contracts",
    "runtime",
    "client",
    "react"
  ],
  "pythonEquivalents": [],
  "alternatives": [],
  "relationships": [],
  "resolutionPriority": 50
}
```

Capability imports:

```json
[
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/adaptive-form",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/contract-data-engine-context",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/contract-result-client",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/contracts-runtime-client-react.feature",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/drivers/rn-reusables",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/drivers/shadcn",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/feature-render",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/form-render",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/form-render.impl",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/i18n",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/lssm-os-operation-status",
    "symbols": [
      "useLssmOsOperationStatusV1"
    ]
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/i18n/catalogs",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-client-react/subscriptions/use-contract-subscription",
    "symbols": [
      "useContractSubscription"
    ]
  }
]
```

## Catalogue metadata

```json
{
  "family": "runtime",
  "kind": "library",
  "status": "active",
  "adoptionMode": "adoptable",
  "stability": "stable",
  "platforms": [
    "web",
    "server"
  ],
  "runtimes": [
    "browser",
    "bun",
    "node"
  ],
  "entrypoints": [
    ".",
    "./adaptive-form",
    "./contract-data-engine-context",
    "./contract-result-client",
    "./contracts-runtime-client-react.feature",
    "./drivers/rn-reusables",
    "./drivers/shadcn",
    "./feature-render",
    "./form-render",
    "./form-render.impl",
    "./i18n",
    "./i18n/catalogs",
    "./i18n/catalogs/en",
    "./i18n/catalogs/es",
    "./i18n/catalogs/fr",
    "./i18n/keys",
    "./i18n/locale",
    "./i18n/messages",
    "./lssm-os-operation-status",
    "./pwa-update-client",
    "./subscriptions/use-contract-subscription",
    "./transform-engine",
    "./use-contract-mutation",
    "./use-contract-query"
  ],
  "examples": [],
  "replacements": [],
  "visualTesting": {
    "status": "deferred",
    "owner": "@contractspec-core",
    "targetWave": "wave-3-react-packages",
    "rationale": "Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates."
  }
}
```

## Canonical imports

Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference.

```json
[
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/adaptive-form",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/contract-data-engine-context",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/contract-result-client",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/contracts-runtime-client-react.feature",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/drivers/rn-reusables",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/drivers/shadcn",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/feature-render",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/form-render",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/form-render.impl",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/i18n",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/lssm-os-operation-status",
    "symbols": [
      "useLssmOsOperationStatusV1"
    ]
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/i18n/catalogs",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.client.react",
    "from": "@lssm-tech/lib.contracts-runtime-client-react/subscriptions/use-contract-subscription",
    "symbols": [
      "useContractSubscription"
    ]
  }
]
```

## Declared export entry points

Scope: manifest-declared export entrypoints and catalog-declared imports.

Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted.

Installation status: not verified.

- `@lssm-tech/lib.contracts-runtime-client-react` — subpath `.`
  - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/index.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/adaptive-form` — subpath `./adaptive-form`
  - `unconditional`: `./src/adaptive-form.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/adaptive-form.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/contract-data-engine-context` — subpath `./contract-data-engine-context`
  - `unconditional`: `./src/contract-data-engine-context.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/contract-data-engine-context.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/contract-result-client` — subpath `./contract-result-client`
  - `unconditional`: `./src/contract-result-client.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/contract-result-client.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/contracts-runtime-client-react.feature` — subpath `./contracts-runtime-client-react.feature`
  - `unconditional`: `./src/contracts-runtime-client-react.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/contracts-runtime-client-react.feature.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/drivers/rn-reusables` — subpath `./drivers/rn-reusables`
  - `unconditional`: `./src/drivers/rn-reusables.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/drivers/rn-reusables.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/drivers/shadcn` — subpath `./drivers/shadcn`
  - `unconditional`: `./src/drivers/shadcn.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/drivers/shadcn.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/feature-render` — subpath `./feature-render`
  - `unconditional`: `./src/feature-render.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/feature-render.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/form-render` — subpath `./form-render`
  - `unconditional`: `./src/form-render.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/form-render.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/form-render.impl` — subpath `./form-render.impl`
  - `unconditional`: `./src/form-render.impl.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/form-render.impl.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n` — subpath `./i18n`
  - `unconditional`: `./src/i18n/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/index.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/catalogs` — subpath `./i18n/catalogs`
  - `unconditional`: `./src/i18n/catalogs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/catalogs/index.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/catalogs/en` — subpath `./i18n/catalogs/en`
  - `unconditional`: `./src/i18n/catalogs/en.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/catalogs/en.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/catalogs/es` — subpath `./i18n/catalogs/es`
  - `unconditional`: `./src/i18n/catalogs/es.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/catalogs/es.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/catalogs/fr` — subpath `./i18n/catalogs/fr`
  - `unconditional`: `./src/i18n/catalogs/fr.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/catalogs/fr.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/keys` — subpath `./i18n/keys`
  - `unconditional`: `./src/i18n/keys.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/keys.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/locale` — subpath `./i18n/locale`
  - `unconditional`: `./src/i18n/locale.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/locale.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/i18n/messages` — subpath `./i18n/messages`
  - `unconditional`: `./src/i18n/messages.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/i18n/messages.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/lssm-os-operation-status` — subpath `./lssm-os-operation-status`
  - `unconditional`: `./src/lssm-os-operation-status.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/lssm-os-operation-status.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/pwa-update-client` — subpath `./pwa-update-client`
  - `unconditional`: `./src/pwa-update-client.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/pwa-update-client.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/subscriptions/use-contract-subscription` — subpath `./subscriptions/use-contract-subscription`
  - `unconditional`: `./src/subscriptions/use-contract-subscription.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/subscriptions/use-contract-subscription.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/transform-engine` — subpath `./transform-engine`
  - `unconditional`: `./src/transform-engine.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/transform-engine.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/use-contract-mutation` — subpath `./use-contract-mutation`
  - `unconditional`: `./src/use-contract-mutation.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/use-contract-mutation.tsx); verified source file.

- `@lssm-tech/lib.contracts-runtime-client-react/use-contract-query` — subpath `./use-contract-query`
  - `unconditional`: `./src/use-contract-query.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/src/use-contract-query.tsx); verified source file.

## Package publication metadata

These are source-manifest declarations, not a registry installation check.

```json
{
  "types": "./dist/index.d.ts",
  "files": [
    "dist",
    "README.md"
  ],
  "publishExports": {
    ".": {
      "types": "./dist/index.d.ts",
      "browser": "./dist/browser/index.js",
      "bun": "./dist/index.js",
      "node": "./dist/node/index.js",
      "default": "./dist/index.js"
    },
    "./adaptive-form": {
      "types": "./dist/adaptive-form.d.ts",
      "browser": "./dist/browser/adaptive-form.js",
      "bun": "./dist/adaptive-form.js",
      "node": "./dist/node/adaptive-form.js",
      "default": "./dist/adaptive-form.js"
    },
    "./contract-data-engine-context": {
      "types": "./dist/contract-data-engine-context.d.ts",
      "browser": "./dist/browser/contract-data-engine-context.js",
      "bun": "./dist/contract-data-engine-context.js",
      "node": "./dist/node/contract-data-engine-context.js",
      "default": "./dist/contract-data-engine-context.js"
    },
    "./contract-result-client": {
      "types": "./dist/contract-result-client.d.ts",
      "browser": "./dist/browser/contract-result-client.js",
      "bun": "./dist/contract-result-client.js",
      "node": "./dist/node/contract-result-client.js",
      "default": "./dist/contract-result-client.js"
    },
    "./contracts-runtime-client-react.feature": {
      "types": "./dist/contracts-runtime-client-react.feature.d.ts",
      "browser": "./dist/browser/contracts-runtime-client-react.feature.js",
      "bun": "./dist/contracts-runtime-client-react.feature.js",
      "node": "./dist/node/contracts-runtime-client-react.feature.js",
      "default": "./dist/contracts-runtime-client-react.feature.js"
    },
    "./drivers/rn-reusables": {
      "types": "./dist/drivers/rn-reusables.d.ts",
      "browser": "./dist/browser/drivers/rn-reusables.js",
      "bun": "./dist/drivers/rn-reusables.js",
      "node": "./dist/node/drivers/rn-reusables.js",
      "default": "./dist/drivers/rn-reusables.js"
    },
    "./drivers/shadcn": {
      "types": "./dist/drivers/shadcn.d.ts",
      "browser": "./dist/browser/drivers/shadcn.js",
      "bun": "./dist/drivers/shadcn.js",
      "node": "./dist/node/drivers/shadcn.js",
      "default": "./dist/drivers/shadcn.js"
    },
    "./feature-render": {
      "types": "./dist/feature-render.d.ts",
      "browser": "./dist/browser/feature-render.js",
      "bun": "./dist/feature-render.js",
      "node": "./dist/node/feature-render.js",
      "default": "./dist/feature-render.js"
    },
    "./form-render": {
      "types": "./dist/form-render.d.ts",
      "browser": "./dist/browser/form-render.js",
      "bun": "./dist/form-render.js",
      "node": "./dist/node/form-render.js",
      "default": "./dist/form-render.js"
    },
    "./form-render.impl": {
      "types": "./dist/form-render.impl.d.ts",
      "browser": "./dist/browser/form-render.impl.js",
      "bun": "./dist/form-render.impl.js",
      "node": "./dist/node/form-render.impl.js",
      "default": "./dist/form-render.impl.js"
    },
    "./i18n": {
      "types": "./dist/i18n/index.d.ts",
      "browser": "./dist/browser/i18n/index.js",
      "bun": "./dist/i18n/index.js",
      "node": "./dist/node/i18n/index.js",
      "default": "./dist/i18n/index.js"
    },
    "./i18n/catalogs": {
      "types": "./dist/i18n/catalogs/index.d.ts",
      "browser": "./dist/browser/i18n/catalogs/index.js",
      "bun": "./dist/i18n/catalogs/index.js",
      "node": "./dist/node/i18n/catalogs/index.js",
      "default": "./dist/i18n/catalogs/index.js"
    },
    "./i18n/catalogs/en": {
      "types": "./dist/i18n/catalogs/en.d.ts",
      "browser": "./dist/browser/i18n/catalogs/en.js",
      "bun": "./dist/i18n/catalogs/en.js",
      "node": "./dist/node/i18n/catalogs/en.js",
      "default": "./dist/i18n/catalogs/en.js"
    },
    "./i18n/catalogs/es": {
      "types": "./dist/i18n/catalogs/es.d.ts",
      "browser": "./dist/browser/i18n/catalogs/es.js",
      "bun": "./dist/i18n/catalogs/es.js",
      "node": "./dist/node/i18n/catalogs/es.js",
      "default": "./dist/i18n/catalogs/es.js"
    },
    "./i18n/catalogs/fr": {
      "types": "./dist/i18n/catalogs/fr.d.ts",
      "browser": "./dist/browser/i18n/catalogs/fr.js",
      "bun": "./dist/i18n/catalogs/fr.js",
      "node": "./dist/node/i18n/catalogs/fr.js",
      "default": "./dist/i18n/catalogs/fr.js"
    },
    "./i18n/keys": {
      "types": "./dist/i18n/keys.d.ts",
      "browser": "./dist/browser/i18n/keys.js",
      "bun": "./dist/i18n/keys.js",
      "node": "./dist/node/i18n/keys.js",
      "default": "./dist/i18n/keys.js"
    },
    "./i18n/locale": {
      "types": "./dist/i18n/locale.d.ts",
      "browser": "./dist/browser/i18n/locale.js",
      "bun": "./dist/i18n/locale.js",
      "node": "./dist/node/i18n/locale.js",
      "default": "./dist/i18n/locale.js"
    },
    "./i18n/messages": {
      "types": "./dist/i18n/messages.d.ts",
      "browser": "./dist/browser/i18n/messages.js",
      "bun": "./dist/i18n/messages.js",
      "node": "./dist/node/i18n/messages.js",
      "default": "./dist/i18n/messages.js"
    },
    "./lssm-os-operation-status": {
      "types": "./dist/lssm-os-operation-status.d.ts",
      "browser": "./dist/browser/lssm-os-operation-status.js",
      "bun": "./dist/lssm-os-operation-status.js",
      "node": "./dist/node/lssm-os-operation-status.js",
      "default": "./dist/lssm-os-operation-status.js"
    },
    "./pwa-update-client": {
      "types": "./dist/pwa-update-client.d.ts",
      "browser": "./dist/browser/pwa-update-client.js",
      "bun": "./dist/pwa-update-client.js",
      "node": "./dist/node/pwa-update-client.js",
      "default": "./dist/pwa-update-client.js"
    },
    "./subscriptions/use-contract-subscription": {
      "types": "./dist/subscriptions/use-contract-subscription.d.ts",
      "browser": "./dist/browser/subscriptions/use-contract-subscription.js",
      "bun": "./dist/subscriptions/use-contract-subscription.js",
      "node": "./dist/node/subscriptions/use-contract-subscription.js",
      "default": "./dist/subscriptions/use-contract-subscription.js"
    },
    "./transform-engine": {
      "types": "./dist/transform-engine.d.ts",
      "browser": "./dist/browser/transform-engine.js",
      "bun": "./dist/transform-engine.js",
      "node": "./dist/node/transform-engine.js",
      "default": "./dist/transform-engine.js"
    },
    "./use-contract-mutation": {
      "types": "./dist/use-contract-mutation.d.ts",
      "browser": "./dist/browser/use-contract-mutation.js",
      "bun": "./dist/use-contract-mutation.js",
      "node": "./dist/node/use-contract-mutation.js",
      "default": "./dist/use-contract-mutation.js"
    },
    "./use-contract-query": {
      "types": "./dist/use-contract-query.d.ts",
      "browser": "./dist/browser/use-contract-query.js",
      "bun": "./dist/use-contract-query.js",
      "node": "./dist/node/use-contract-query.js",
      "default": "./dist/use-contract-query.js"
    }
  }
}
```

## Dependencies

Metadata status: complete pinned manifest.

### Runtime dependencies

- [@lssm-tech/lib.contracts-runtime-kernel](https://lssm.co/docs/packages/lib.contracts-runtime-kernel/): `workspace:^`
- [@lssm-tech/lib.contracts-spec-core](https://lssm.co/docs/packages/lib.contracts-spec-core/): `workspace:^`
- [@lssm-tech/lib.forms-runtime](https://lssm.co/docs/packages/lib.forms-runtime/): `workspace:^`
- [@lssm-tech/lib.lssm-os-runtime](https://lssm.co/docs/packages/lib.lssm-os-runtime/): `workspace:^`
- [@lssm-tech/lib.personalization](https://lssm.co/docs/packages/lib.personalization/): `workspace:^`
- [@lssm-tech/lib.presentation-runtime-core](https://lssm.co/docs/packages/lib.presentation-runtime-core/): `workspace:^`
- [@lssm-tech/lib.schema](https://lssm.co/docs/packages/lib.schema/): `workspace:^`
- [@lssm-tech/lib.translation-runtime](https://lssm.co/docs/packages/lib.translation-runtime/): `workspace:^`

### Peer dependencies

- `@hookform/resolvers`: `catalog:ui`
- `@types/react`: `catalog:types`
- `react`: `catalog:`
- `react-dom`: `catalog:`
- `react-hook-form`: `catalog:ui`

### Optional dependencies

No declarations in the inspected manifest.

### Development dependencies

- [@lssm-tech/lib.design-catalog](https://lssm.co/docs/packages/lib.design-catalog/): `workspace:^`
- [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*`
- [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*`
- `happy-dom`: `catalog:testing`
- `typescript`: `catalog:`

### Peer dependency metadata

```json
{}
```

### Bundled dependencies

```json
null
```

## Package scripts

Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest.

```json
{
  "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
  "publish:pkg:canary": "bun publish:pkg --tag canary",
  "clean": "rm -rf dist",
  "lint": "bun run lint:fix",
  "lint:fix": "node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .",
  "lint:check": "node ../../../../scripts/biome.cjs check .",
  "pack:verify": "bun run build && bun scripts/verify-packed-package.ts",
  "build": "contractspec-bun-build build",
  "build:bundle": "contractspec-bun-build transpile",
  "build:types": "contractspec-bun-build types",
  "prebuild": "contractspec-bun-build prebuild",
  "typecheck": "tsgo --noEmit",
  "dev": "contractspec-bun-build dev"
}
```

## Declared documentation links

- [Lib Contracts Runtime Client React documentation](https://www.npmjs.com/package/%40lssm-tech%2Flib.contracts-runtime-client-react) — declared link; destination not verified.

```json
{
  "url": "https://www.npmjs.com/package/%40lssm-tech%2Flib.contracts-runtime-client-react",
  "kind": "readme"
}
```

## Existing agent-guide projection

```json
{
  "path": "packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-client-react.txt",
  "route": "/llms/lib.contracts-runtime-client-react",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-client-react.txt",
  "blobSha": "98c913ba37cca28d313ac34b4e6836c7b57b8538",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "bodyEqualsReadme": true,
  "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt",
  "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf"
}
```