{"id":"@lssm-tech/lib.typescript-runtime","slug":"lib.typescript-runtime","name":"@lssm-tech/lib.typescript-runtime","version":"2.0.5","path":"packages/tools/typescript-runtime","manifestPath":"packages/tools/typescript-runtime/package.json","manifestBlobSha":"6879308da658fde4f38945ad6ad30d26bec9ab3d","layer":"tools","physicalArea":null,"primaryArea":"tooling-and-agent-delivery","classification":{"privateDeclared":null,"catalogFamily":"runtime","catalogKind":"library","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Owned TypeScript compiler API boundary for ContractSpec tooling","descriptionOrigin":"package.json","catalog":{"family":"runtime","kind":"library","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./docs-manifest-builder"],"documentation":[{"title":"Lib Typescript Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.typescript-runtime","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.lib.typescript.runtime","title":"Lib Typescript Runtime","description":"Owned TypeScript compiler API boundary for ContractSpec tooling","status":"active","useCases":["Adopt owned typescript compiler api boundary for contractspec tooling"],"aliases":["contractspec","typescript","compiler","ast","lib","runtime"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/lib.typescript-runtime","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/lib.typescript-runtime package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}]},"canonicalImports":[{"capabilityId":"package.lssm.tech.lib.typescript.runtime","from":"@lssm-tech/lib.typescript-runtime","symbols":[]}],"scripts":{"build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","clean":"rm -rf dist","dev":"contractspec-bun-build dev","lint":"bun run lint:fix","lint:check":"node ../../../scripts/biome.cjs check .","lint:fix":"node ../../../scripts/biome.cjs check --write .","prebuild":"contractspec-bun-build prebuild","test":"bun test","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"typescript":"catalog:","@lssm-tech/lib.contracts-spec-core":"workspace:^","@lssm-tech/lib.surface-runtime":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./docs-manifest-builder":{"types":"./src/docs-manifest-builder.ts","browser":null,"bun":"./src/docs-manifest-builder.ts","node":"./src/docs-manifest-builder.ts","default":"./src/docs-manifest-builder.ts"}},"publishExports":{".":{"types":"./dist/index.d.ts","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./docs-manifest-builder":{"types":"./dist/docs-manifest-builder.d.ts","browser":null,"bun":"./dist/docs-manifest-builder.js","node":"./dist/node/docs-manifest-builder.js","default":"./dist/docs-manifest-builder.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/lib.typescript-runtime","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/tools/typescript-runtime/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs-manifest-builder","importPath":"@lssm-tech/lib.typescript-runtime/docs-manifest-builder","target":{"types":"./src/docs-manifest-builder.ts","browser":null,"bun":"./src/docs-manifest-builder.ts","node":"./src/docs-manifest-builder.ts","default":"./src/docs-manifest-builder.ts"},"targets":[{"conditions":["types"],"target":"./src/docs-manifest-builder.ts","sourcePath":"packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceStatus":"verified source file"},{"conditions":["browser"],"target":null,"sourcePath":null,"sourceUrl":null,"sourceStatus":"blocked export"},{"conditions":["bun"],"target":"./src/docs-manifest-builder.ts","sourcePath":"packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceStatus":"verified source file"},{"conditions":["node"],"target":"./src/docs-manifest-builder.ts","sourcePath":"packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceStatus":"verified source file"},{"conditions":["default"],"target":"./src/docs-manifest-builder.ts","sourcePath":"packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/src/docs-manifest-builder.ts","sourceStatus":"verified source file"}]}],"entryCount":2,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Lib Typescript Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.typescript-runtime","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.typescript-runtime.txt"},"readme":{"status":"available","body":"# @lssm-tech/lib.typescript-runtime\n\nOwned runtime boundary for TypeScript compiler and AST access.\n\nConsumers import AST helpers and source parsing from this package so TypeScript\nupgrades have one repair point. The adapter isolates TypeScript 7's unstable\nAST and asynchronous compiler APIs while preserving a stable asynchronous\nparser contract for callers.\n\n```ts\nimport {\n\tTypeScriptSourceParser,\n\tisVariableStatement,\n} from \"@lssm-tech/lib.typescript-runtime\";\n```\n\nCall `close()` on long-lived parsers after use.\n\nThe explicit server-only `@lssm-tech/lib.typescript-runtime/docs-manifest-builder`\nentry owns compiler-backed same-file DocBlock extraction and package manifest\ngeneration. It exports `extractModuleDocData` and `buildPackageDocManifest` with\ntheir existing asynchronous signatures and is the canonical import path. The\ndeprecated `@lssm-tech/lib.contracts-spec/docs/manifest-builder` subpath\nforwards the same function identities until the next major release of\n`@lssm-tech/lib.contracts-spec` removes it; new code imports this entry. This\nentry rejects browser resolution and is not reexported by the root AST adapter.\nManifest and DocBlock types remain owned by surface-runtime and\ncontracts-spec-core, respectively.\n\n`buildPackageDocManifest({ followReexports: true, ... })` additionally follows\nstatic value reexports to canonical same-file DocBlocks. The option is additive\nand defaults to `false`; existing callers keep their source-root-only behavior.\nThe compatibility package's `docs:manifest` producer imports this entry directly\nand enables it so moving a contract into its canonical owner does not remove its\ndocumentation. Traversal does not execute source modules or scan private sibling\nfiles. Named aliases, cycles, and explicit export precedence are respected;\nambiguous documentation bindings, duplicate identifiers/routes, and missing\nreferences fail validation.\nDocBlock identifiers and payloads are preserved, while `sourceModule` identifies\nthe canonical package and source file for documentation outside the input root.\n\nEach parser owns an isolated temporary workspace and native TypeScript session.\nOn Windows, the adapter uses the compiler client's supported stdio transport;\nother platforms retain Unix sockets. This avoids Windows named-pipe readiness\nand naming races without changing the asynchronous parser API or snapshot\nsemantics. The matching native TypeScript executable must be installed.\n\nThe root build targets Node-compatible server execution (including Bun). It\nrequires filesystem, process, or native compiler facilities and does not advertise\na browser export condition. Browser applications should use the relevant\nbrowser-safe contracts or UI entry points instead of importing this server root.\n","sourcePath":"packages/tools/typescript-runtime/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/typescript-runtime/README.md","blobSha":"7ecfd45539c8fea82c670ed0b25be523ca09d863","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"tooling-and-agent-delivery","areaTitle":"CLI, authoring and agent tooling","displayName":"lib.typescript-runtime","runtimes":["node"],"platforms":["server"],"kind":"library","scope":"Package manifest","canonicalRoute":"/docs/packages/lib.typescript-runtime/","contextUrl":"/docs/packages/lib.typescript-runtime.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}