lib.presentation-runtime-react
React presentation runtime with workflow components
@lssm-tech/lib.presentation-runtime-reactbun add @lssm-tech/lib.presentation-runtime-reactManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
React presentation runtime with workflow components.
What It Provides
- Layer: lib.
- Consumers: bundles, apps.
- Related ContractSpec packages include
@lssm-tech/lib.contracts-spec,@lssm-tech/lib.presentation-runtime-core,@lssm-tech/lib.ui-kit-web,@lssm-tech/tool.bun. - Related ContractSpec packages include
@lssm-tech/lib.contracts-spec,@lssm-tech/lib.presentation-runtime-core,@lssm-tech/lib.ui-kit-web,@lssm-tech/tool.bun.
Installation
npm install @lssm-tech/lib.presentation-runtime-react
or
bun add @lssm-tech/lib.presentation-runtime-react
Usage
Import the root entrypoint from @lssm-tech/lib.presentation-runtime-react, or choose a documented subpath when you only need one part of the package surface.
Adaptive Data Views
useAdaptiveDataView connects ContractSpec adaptive experience state to DataView renderers. It resolves safe defaults for view mode, density, data depth, and page size, then emits neutral interaction evidence when users manually change DataView settings.
The hook is intentionally vertical-agnostic: applications provide context, policy, constraints, and optional event emitters; the hook returns renderer props and explainable state. Explicit user choices remain stronger than inferred behavior, and emitted events describe observations rather than user labels.
Architecture
src/index.tsis the root public barrel and package entrypoint.src/nativewind-env.d.tsis part of the package's public or composition surface.src/presentation-runtime-react.feature.tsis part of the package's public or composition surface.src/table.state.tsis part of the package's public or composition surface.src/table.types.tsis part of the package's public or composition surface.src/table.utils.test.tsis part of the package's public or composition surface.src/table.utils.tsis part of the package's public or composition surface.src/useContractTable.models.tsxis part of the package's public or composition surface.src/useContractTable.tsxis part of the package's public or composition surface.src/useAdaptiveDataView.tsis part of the package's public or composition surface.
Public Entry Points
- Export
.resolves through./src/index.ts. - Export
./nativewind-env.dresolves through./src/nativewind-env.d.ts. - Export
./presentation-runtime-react.featureresolves through./src/presentation-runtime-react.feature.ts. - Export
./table.stateresolves through./src/table.state.ts. - Export
./table.typesresolves through./src/table.types.ts. - Export
./table.utilsresolves through./src/table.utils.ts. - Export
./useContractTableresolves through./src/useContractTable.tsx. - Export
./useContractTable.modelsresolves through./src/useContractTable.models.tsx. - Export
./useAdaptiveDataViewresolves through./src/useAdaptiveDataView.ts. - Export
./useDataViewTableresolves through./src/useDataViewTable.tsx. - Export
./useVisualizationModelresolves through./src/useVisualizationModel.ts. - Export
./useWorkflowresolves through./src/useWorkflow.ts. - Export
./WorkflowStepperresolves through./src/WorkflowStepper.tsx. - Export
./WorkflowStepRendererresolves through./src/WorkflowStepRenderer.tsx. - The package publishes 13 export subpaths plus the root entrypoint; keep docs aligned with
package.json.
Local Commands
bun run dev— contractspec-bun-build devbun run build— contractspec-bun-build buildbun run lint— bun run lint:fixbun run lint:check— biome check .bun run lint:fix— biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .bun run typecheck— tsgo --noEmit -p tsconfig.jsonbun run publish:pkg— bun publish --tolerate-republish --ignore-scripts --verbosebun run publish:pkg:canary— bun publish:pkg --tag canarybun run build:bundle— contractspec-bun-build transpilebun run build:types— contractspec-bun-build typesbun run prebuild— contractspec-bun-build prebuild
Recent Updates
- Replace eslint+prettier by biomejs to optimize speed.
- Add data visualization capabilities.
- Add table capabilities.
- Propagate DataView table overflow metadata through
useDataViewTableso renderers can truncate, wrap, expand, or initially hide columns consistently. - Add
useAdaptiveDataViewfor adaptive DataView defaults and neutral interaction events.
Notes
- Workflow component API is consumed by bundles — breaking changes require coordinated updates.
- Must stay compatible with presentation-runtime-core interface.
- Hook signatures (
useWorkflow) are public API; parameter changes are breaking.
Standalone declaration exports keep their existing public subpath names. The shared builder preserves their original declaration suffix and copies checked source declarations into dist, without overwriting emitted implementation types.
The canonical import migration preserves renderer signatures, refresh defaults, state handling, test assertions and public export maps. It requires the complete OrchestrationSpec workflow models, nominal WorkflowComposer runner/state family and PresentationRuntimeCore portable adaptive family to join together. The candidate has no direct compatibility-package source imports; task-bound adoption, producer, compiler and affected consumer qualification remain pending. It must not be adopted before those complete suppliers are available.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
8 declarations
@tanstack/react-table^9.2.4
@lssm-tech/lib.presentation-runtime-coreworkspace:^
Read the package manual ↗@lssm-tech/lib.personalizationworkspace:^
Read the package manual ↗@lssm-tech/lib.ui-kit-webworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗@lssm-tech/lib.translation-runtimeworkspace:^
Read the package manual ↗
Declared capabilities
React presentation runtime with workflow components
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devlintbun run lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun test --pass-with-no-testsprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit -p tsconfig.json