attention-manifest-protocol 0.4.2 → 0.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +341 -293
- package/CHANGELOG.zh-CN.md +41 -8
- package/README.md +250 -171
- package/README.zh-CN.md +251 -171
- package/lib/assignment/assign.d.ts +102 -0
- package/lib/assignment/assign.js +556 -0
- package/lib/assignment/binding.d.ts +103 -0
- package/lib/assignment/binding.js +575 -0
- package/lib/assignment/errors.d.ts +14 -0
- package/lib/assignment/errors.js +16 -0
- package/lib/assignment/guards.d.ts +18 -0
- package/lib/assignment/guards.js +28 -0
- package/lib/assignment/index.d.ts +10 -0
- package/lib/assignment/index.js +10 -0
- package/lib/assignment/types.d.ts +169 -0
- package/lib/assignment/types.js +1 -0
- package/lib/attention/budget.d.ts +1 -1
- package/lib/attention/budget.js +31 -9
- package/lib/bayes/engine.js +2 -1
- package/lib/bayes/reliability.js +25 -10
- package/lib/boundary/frame.d.ts +10 -4
- package/lib/boundary/frame.js +346 -109
- package/lib/boundary/kinds.d.ts +11 -0
- package/lib/boundary/kinds.js +33 -0
- package/lib/boundary/refTable.d.ts +19 -9
- package/lib/boundary/refTable.js +128 -30
- package/lib/boundary/toolCall.d.ts +22 -10
- package/lib/boundary/toolCall.js +798 -97
- package/lib/concept/conceptBudget.js +10 -1
- package/lib/concurrency/idempotency.d.ts +4 -3
- package/lib/concurrency/idempotency.js +57 -13
- package/lib/concurrency/retry.js +18 -3
- package/lib/context/agentContext.d.ts +13 -0
- package/lib/context/agentContext.js +14 -1
- package/lib/context/ast.d.ts +4 -1
- package/lib/context/ast.js +13 -3
- package/lib/context/contentStore.js +22 -9
- package/lib/context/contextBuilder.d.ts +457 -0
- package/lib/context/contextBuilder.js +1395 -0
- package/lib/context/contextPackage.d.ts +214 -0
- package/lib/context/contextPackage.js +191 -0
- package/lib/context/index.d.ts +14 -3
- package/lib/context/index.js +9 -1
- package/lib/context/relevance.d.ts +171 -0
- package/lib/context/relevance.js +250 -0
- package/lib/context/workspaceDiff.d.ts +105 -0
- package/lib/context/workspaceDiff.js +238 -0
- package/lib/context/workspaceService.d.ts +236 -1
- package/lib/context/workspaceService.js +1501 -73
- package/lib/cooperation/collaboration.d.ts +9 -0
- package/lib/cooperation/session.d.ts +4 -4
- package/lib/cooperation/session.js +3 -3
- package/lib/database/adapter/filesystemStore.d.ts +145 -0
- package/lib/database/adapter/filesystemStore.js +321 -0
- package/lib/database/adapter/index.d.ts +2 -0
- package/lib/database/adapter/index.js +2 -0
- package/lib/database/adapter/workspaceSessionStore.d.ts +118 -0
- package/lib/database/adapter/workspaceSessionStore.js +120 -0
- package/lib/database/entity/fileGraph.d.ts +53 -0
- package/lib/database/entity/fileGraph.js +15 -0
- package/lib/database/entity/fileTree.d.ts +76 -0
- package/lib/database/entity/fileTree.js +39 -0
- package/lib/database/entity/hook.d.ts +29 -0
- package/lib/database/entity/hook.js +18 -0
- package/lib/database/entity/index.d.ts +4 -0
- package/lib/database/entity/index.js +4 -0
- package/lib/database/entity/workspaceSession.d.ts +53 -0
- package/lib/database/entity/workspaceSession.js +28 -0
- package/lib/database/repository/fileAnnotationRepository.d.ts +75 -0
- package/lib/database/repository/fileAnnotationRepository.js +109 -0
- package/lib/database/repository/fileGraphRepository.d.ts +188 -0
- package/lib/database/repository/fileGraphRepository.js +648 -0
- package/lib/database/repository/fileNodeRepository.d.ts +116 -0
- package/lib/database/repository/fileNodeRepository.js +263 -0
- package/lib/database/repository/fileOutlineRepository.d.ts +40 -0
- package/lib/database/repository/fileOutlineRepository.js +104 -0
- package/lib/database/repository/fileWriteRepository.d.ts +41 -0
- package/lib/database/repository/fileWriteRepository.js +93 -0
- package/lib/database/repository/hookRepository.d.ts +67 -0
- package/lib/database/repository/hookRepository.js +150 -0
- package/lib/database/repository/index.d.ts +7 -0
- package/lib/database/repository/index.js +7 -0
- package/lib/database/repository/workspaceSessionRepository.d.ts +134 -0
- package/lib/database/repository/workspaceSessionRepository.js +327 -0
- package/lib/database/service/database.d.ts +14 -0
- package/lib/database/service/database.js +21 -0
- package/lib/database/sql/schema.js +187 -0
- package/lib/database/store/database.js +6 -1
- package/lib/delegate/team.d.ts +5 -0
- package/lib/delegate/team.js +83 -20
- package/lib/discover/classify.d.ts +20 -0
- package/lib/discover/classify.js +85 -0
- package/lib/discover/host.d.ts +20 -0
- package/lib/discover/host.js +89 -0
- package/lib/discover/index.d.ts +11 -0
- package/lib/discover/index.js +11 -0
- package/lib/discover/kinds.d.ts +14 -0
- package/lib/discover/kinds.js +23 -0
- package/lib/discover/tree.d.ts +7 -0
- package/lib/discover/tree.js +432 -0
- package/lib/discover/types.d.ts +115 -0
- package/lib/discover/types.js +1 -0
- package/lib/error/boundaryRejection.d.ts +1 -1
- package/lib/evaluation/agreement.js +2 -2
- package/lib/execution/handles.js +6 -0
- package/lib/execution/pin.js +2 -2
- package/lib/file/cfb.d.ts +56 -0
- package/lib/file/cfb.js +396 -0
- package/lib/file/dependency.d.ts +151 -0
- package/lib/file/dependency.js +568 -0
- package/lib/file/directory.d.ts +34 -0
- package/lib/file/directory.js +141 -0
- package/lib/file/errors.d.ts +20 -0
- package/lib/file/errors.js +18 -0
- package/lib/file/exportGraph.d.ts +31 -0
- package/lib/file/exportGraph.js +554 -0
- package/lib/file/file.d.ts +40 -0
- package/lib/file/file.js +339 -0
- package/lib/file/importGraph.d.ts +121 -0
- package/lib/file/importGraph.js +1022 -0
- package/lib/file/index.d.ts +45 -0
- package/lib/file/index.js +30 -0
- package/lib/file/metadata.d.ts +66 -0
- package/lib/file/metadata.js +470 -0
- package/lib/file/path.d.ts +60 -0
- package/lib/file/path.js +259 -0
- package/lib/file/read.d.ts +168 -0
- package/lib/file/read.js +541 -0
- package/lib/file/runtime.d.ts +95 -0
- package/lib/file/runtime.js +150 -0
- package/lib/file/service.d.ts +227 -0
- package/lib/file/service.js +663 -0
- package/lib/file/syntaxTree.d.ts +7 -0
- package/lib/file/syntaxTree.js +38 -0
- package/lib/file/time.d.ts +38 -0
- package/lib/file/time.js +44 -0
- package/lib/file/tree.d.ts +53 -0
- package/lib/file/tree.js +417 -0
- package/lib/file/types.d.ts +371 -0
- package/lib/file/types.js +1 -0
- package/lib/file/write.d.ts +159 -0
- package/lib/file/write.js +1028 -0
- package/lib/file/zip.d.ts +35 -0
- package/lib/file/zip.js +349 -0
- package/lib/fingerprint/algorithm.d.ts +97 -0
- package/lib/fingerprint/algorithm.js +271 -0
- package/lib/fingerprint/bytes.d.ts +18 -0
- package/lib/fingerprint/bytes.js +31 -0
- package/lib/fingerprint/error.d.ts +73 -0
- package/lib/fingerprint/error.js +86 -0
- package/lib/fingerprint/file.d.ts +71 -0
- package/lib/fingerprint/file.js +254 -0
- package/lib/fingerprint/index.d.ts +37 -0
- package/lib/fingerprint/index.js +12 -0
- package/lib/fingerprint/json.d.ts +41 -0
- package/lib/fingerprint/json.js +94 -0
- package/lib/fingerprint/number.d.ts +32 -0
- package/lib/fingerprint/number.js +95 -0
- package/lib/fingerprint/policy.d.ts +54 -0
- package/lib/fingerprint/policy.js +50 -0
- package/lib/fingerprint/preimage.d.ts +84 -0
- package/lib/fingerprint/preimage.js +133 -0
- package/lib/fingerprint/raw.d.ts +26 -0
- package/lib/fingerprint/raw.js +45 -0
- package/lib/fingerprint/ref.d.ts +39 -0
- package/lib/fingerprint/ref.js +178 -0
- package/lib/fingerprint/text.d.ts +42 -0
- package/lib/fingerprint/text.js +155 -0
- package/lib/fingerprint/tree.d.ts +56 -0
- package/lib/fingerprint/tree.js +288 -0
- package/lib/fingerprint/verify.d.ts +20 -0
- package/lib/fingerprint/verify.js +99 -0
- package/lib/global/filesystem.d.ts +43 -0
- package/lib/global/filesystem.js +75 -0
- package/lib/global/index.d.ts +8 -0
- package/lib/global/index.js +8 -0
- package/lib/global/service.d.ts +51 -0
- package/lib/global/service.js +98 -0
- package/lib/governance/transport.js +18 -6
- package/lib/hook/ast.d.ts +29 -0
- package/lib/hook/ast.js +22 -0
- package/lib/hook/code.d.ts +55 -0
- package/lib/hook/code.js +47 -0
- package/lib/hook/dependency.d.ts +45 -0
- package/lib/hook/dependency.js +28 -0
- package/lib/hook/diff.d.ts +114 -0
- package/lib/hook/diff.js +327 -0
- package/lib/hook/exportation.d.ts +31 -0
- package/lib/hook/exportation.js +24 -0
- package/lib/hook/file.d.ts +44 -0
- package/lib/hook/file.js +154 -0
- package/lib/hook/importation.d.ts +33 -0
- package/lib/hook/importation.js +22 -0
- package/lib/hook/index.d.ts +30 -0
- package/lib/hook/index.js +23 -0
- package/lib/hook/outline.d.ts +35 -0
- package/lib/hook/outline.js +27 -0
- package/lib/hook/project.d.ts +65 -0
- package/lib/hook/project.js +217 -0
- package/lib/hook/types.d.ts +114 -0
- package/lib/hook/types.js +407 -0
- package/lib/index.d.ts +9 -0
- package/lib/index.js +9 -0
- package/lib/lock/lease.js +28 -3
- package/lib/manifest/cardSign.d.ts +1 -1
- package/lib/manifest/cardSign.js +37 -7
- package/lib/manifest/federation.js +13 -6
- package/lib/manifest/trust.d.ts +2 -0
- package/lib/manifest/trust.js +27 -6
- package/lib/module/index.d.ts +4 -0
- package/lib/module/index.js +4 -0
- package/lib/module/mcp/client.js +21 -2
- package/lib/module/mcp/filesystemServer.d.ts +24 -0
- package/lib/module/mcp/filesystemServer.js +102 -0
- package/lib/module/mcp/http.js +32 -19
- package/lib/module/mcp/workspaceServer.js +20 -3
- package/lib/module/tool/filesystemExecutor.d.ts +18 -0
- package/lib/module/tool/filesystemExecutor.js +49 -0
- package/lib/module/tool/globalExecutor.d.ts +17 -0
- package/lib/module/tool/globalExecutor.js +39 -0
- package/lib/module/tool/globalFilesystemExecutor.d.ts +18 -0
- package/lib/module/tool/globalFilesystemExecutor.js +49 -0
- package/lib/module/tool/workspaceExecutor.d.ts +9 -0
- package/lib/module/tool/workspaceExecutor.js +16 -3
- package/lib/naming/aliases.d.ts +48 -0
- package/lib/naming/aliases.js +79 -0
- package/lib/naming/catalog.d.ts +117 -0
- package/lib/naming/catalog.js +108 -0
- package/lib/naming/grammar.d.ts +67 -0
- package/lib/naming/grammar.js +212 -0
- package/lib/naming/ids.d.ts +157 -0
- package/lib/naming/ids.js +119 -0
- package/lib/naming/index.d.ts +13 -0
- package/lib/naming/index.js +13 -0
- package/lib/outline/index.d.ts +9 -0
- package/lib/outline/index.js +8 -0
- package/lib/outline/office.d.ts +160 -0
- package/lib/outline/office.js +2375 -0
- package/lib/outline/officeBridge.d.ts +32 -0
- package/lib/outline/officeBridge.js +27 -0
- package/lib/outline/outline.d.ts +159 -0
- package/lib/outline/outline.js +837 -0
- package/lib/outline/outlineIndex.d.ts +97 -0
- package/lib/outline/outlineIndex.js +325 -0
- package/lib/outline/outlineKeywords.d.ts +59 -0
- package/lib/outline/outlineKeywords.js +143 -0
- package/lib/outline/outlineStrategies.d.ts +414 -0
- package/lib/outline/outlineStrategies.js +8324 -0
- package/lib/outline/reactOutline.d.ts +37 -0
- package/lib/outline/reactOutline.js +1070 -0
- package/lib/outline/shellOutline.d.ts +65 -0
- package/lib/outline/shellOutline.js +873 -0
- package/lib/outline/sqlOutline.d.ts +170 -0
- package/lib/outline/sqlOutline.js +1536 -0
- package/lib/outline/strategy.d.ts +46 -0
- package/lib/outline/strategy.js +1 -0
- package/lib/outline/types.d.ts +95 -0
- package/lib/outline/types.js +1 -0
- package/lib/outline/visualBasicOutline.d.ts +27 -0
- package/lib/outline/visualBasicOutline.js +750 -0
- package/lib/protocol/filesystem.d.ts +55 -0
- package/lib/protocol/filesystem.js +105 -0
- package/lib/protocol/global.d.ts +42 -0
- package/lib/protocol/global.js +63 -0
- package/lib/protocol/globalFilesystem.d.ts +40 -0
- package/lib/protocol/globalFilesystem.js +59 -0
- package/lib/protocol/index.d.ts +4 -0
- package/lib/protocol/index.js +4 -0
- package/lib/protocol/protocol.d.ts +4 -0
- package/lib/protocol/wire.js +5 -2
- package/lib/protocol/workspace.d.ts +305 -0
- package/lib/protocol/workspace.js +258 -0
- package/lib/receipt/receipt.d.ts +8 -0
- package/lib/registry/content.js +9 -3
- package/lib/runtime/kernelRuntime.js +9 -1
- package/lib/scenario/scenario.js +5 -4
- package/lib/semantic/canonical.d.ts +61 -0
- package/lib/semantic/canonical.js +135 -8
- package/lib/semantic/jsonValue.d.ts +31 -0
- package/lib/semantic/jsonValue.js +122 -0
- package/lib/semantic/sha256.js +3 -0
- package/lib/semantic/time.d.ts +14 -0
- package/lib/semantic/time.js +56 -0
- package/lib/session/context.d.ts +76 -0
- package/lib/session/context.js +419 -0
- package/lib/session/errors.d.ts +24 -0
- package/lib/session/errors.js +22 -0
- package/lib/session/identity.d.ts +24 -0
- package/lib/session/identity.js +56 -0
- package/lib/session/index.d.ts +14 -0
- package/lib/session/index.js +12 -0
- package/lib/session/registry.d.ts +130 -0
- package/lib/session/registry.js +908 -0
- package/lib/session/types.d.ts +227 -0
- package/lib/session/types.js +14 -0
- package/lib/structure/index.d.ts +1 -0
- package/lib/structure/index.js +1 -0
- package/lib/structure/trie.d.ts +88 -0
- package/lib/structure/trie.js +183 -0
- package/lib/syntax/byteIndex.d.ts +44 -0
- package/lib/syntax/byteIndex.js +148 -0
- package/lib/syntax/charset.d.ts +88 -0
- package/lib/syntax/charset.js +276 -0
- package/lib/syntax/index.d.ts +6 -0
- package/lib/syntax/index.js +5 -0
- package/lib/syntax/syntaxRegistry.d.ts +150 -0
- package/lib/syntax/syntaxRegistry.js +314 -0
- package/lib/syntax/syntaxTree.d.ts +106 -0
- package/lib/syntax/syntaxTree.js +668 -0
- package/lib/syntax/types.d.ts +15 -0
- package/lib/syntax/types.js +1 -0
- package/lib/types/common.d.ts +1 -1
- package/package.json +72 -193
- package/.editorconfig +0 -12
- package/.prettierignore +0 -17
- package/MCP-Token/347/250/216/344/270/216/344/270/213/344/270/200/344/273/243/345/267/245/345/205/267/345/215/217/350/256/256.html +0 -1763
- package/docs/annotation-campaign-A.csv +0 -54
- package/docs/annotation-campaign-B.csv +0 -54
- package/docs/annotation-campaign.csv +0 -54
- package/docs/eval/annotations-A.jsonl +0 -16
- package/docs/eval/annotations.json +0 -122
- package/docs/eval/recorded-labels.json +0 -12
- package/docs/eval/replay-cases.json +0 -14
- package/docs/eval/replay-labels-b.json +0 -14
- package/docs/examples/attention-request.json +0 -16
- package/docs/examples/checkpoint.json +0 -15
- package/docs/examples/claim.json +0 -66
- package/docs/examples/collaboration.json +0 -66
- package/docs/examples/concept-checkpoint.json +0 -15
- package/docs/examples/concept-prune-plan.json +0 -45
- package/docs/examples/federation.json +0 -126
- package/docs/examples/frame-chain.json +0 -77
- package/docs/examples/ledger-snapshot.json +0 -108
- package/docs/examples/manifest.json +0 -77
- package/docs/examples/message.json +0 -19
- package/docs/examples/other-model.json +0 -45
- package/docs/examples/plan.json +0 -50
- package/docs/examples/prune-plan.json +0 -48
- package/docs/examples/receipt.json +0 -22
- package/docs/examples/runtime-run.json +0 -573
- package/docs/examples/team.json +0 -66
- package/docs/examples/verb-note.json +0 -11
- package/docs/probes/bayes-scores.json +0 -1452
- package/docs/probes/calibration-imported.json +0 -141
- package/docs/probes/context-ast-deepseek.json +0 -1577
- package/docs/probes/deepseek-probe.json +0 -917
- package/docs/probes/eval-recorded-replay.json +0 -597
- package/docs/probes/eval-replay.json +0 -124
- package/docs/probes/eval-summary.json +0 -42
- package/docs/probes/runtime-eval.json +0 -4230
- package/docs/schemas/collaboration.schema.json +0 -73
- package/docs/schemas/common.schema.json +0 -125
- package/docs/schemas/compaction.schema.json +0 -121
- package/docs/schemas/concept-compaction.schema.json +0 -73
- package/docs/schemas/concept.schema.json +0 -97
- package/docs/schemas/epistemic.schema.json +0 -178
- package/docs/schemas/federation.schema.json +0 -66
- package/docs/schemas/frame.schema.json +0 -86
- package/docs/schemas/ledger-snapshot.schema.json +0 -30
- package/docs/schemas/manifest.schema.json +0 -169
- package/docs/schemas/message.schema.json +0 -41
- package/docs/schemas/plan.schema.json +0 -189
- package/docs/schemas/receipt.schema.json +0 -45
- package/docs/schemas/social.schema.json +0 -153
- package/docs/schemas/team.schema.json +0 -56
- package/docs/schemas/verb.schema.json +0 -120
- package/eslint.config.mts +0 -96
- package/index.html +0 -13
- package/lib/context/workspaceProtocol.d.ts +0 -30
- package/lib/context/workspaceProtocol.js +0 -49
- package/prettier.config.mts +0 -37
- package/public/favicon.svg +0 -1
- package/public/icons.svg +0 -24
- package/src/attention/attention.ts +0 -347
- package/src/attention/budget.ts +0 -72
- package/src/attention/cognition.ts +0 -519
- package/src/attention/index.ts +0 -8
- package/src/attention/interrupts.ts +0 -228
- package/src/attention/resource.ts +0 -316
- package/src/attention/social.ts +0 -217
- package/src/attention/socialTypes.ts +0 -115
- package/src/authz/authz.ts +0 -305
- package/src/authz/index.ts +0 -1
- package/src/bayes/calibration.ts +0 -204
- package/src/bayes/calibrationRegistry.ts +0 -111
- package/src/bayes/calibrationSelection.ts +0 -154
- package/src/bayes/engine.ts +0 -532
- package/src/bayes/index.ts +0 -6
- package/src/bayes/reliability.ts +0 -62
- package/src/bayes/scopedPriors.ts +0 -88
- package/src/boundary/frame.ts +0 -322
- package/src/boundary/ids.ts +0 -14
- package/src/boundary/index.ts +0 -12
- package/src/boundary/refTable.ts +0 -125
- package/src/boundary/toolCall.ts +0 -212
- package/src/concept/concept.ts +0 -75
- package/src/concept/conceptBudget.ts +0 -346
- package/src/concept/conceptBudgetTypes.ts +0 -79
- package/src/concept/index.ts +0 -3
- package/src/concurrency/idempotency.ts +0 -41
- package/src/concurrency/index.ts +0 -5
- package/src/concurrency/mutex.ts +0 -26
- package/src/concurrency/namedLocks.ts +0 -35
- package/src/concurrency/retry.ts +0 -50
- package/src/concurrency/worker.ts +0 -128
- package/src/context/agentContext.ts +0 -308
- package/src/context/ast.ts +0 -499
- package/src/context/contentStore.ts +0 -75
- package/src/context/context.ts +0 -65
- package/src/context/contextIndex.ts +0 -85
- package/src/context/document.ts +0 -137
- package/src/context/fileStorePath.ts +0 -14
- package/src/context/index.ts +0 -43
- package/src/context/lifecycle.ts +0 -221
- package/src/context/projections.ts +0 -151
- package/src/context/workspace.ts +0 -422
- package/src/context/workspaceProtocol.ts +0 -112
- package/src/context/workspaceService.ts +0 -423
- package/src/cooperation/board.ts +0 -104
- package/src/cooperation/collaboration.ts +0 -60
- package/src/cooperation/index.ts +0 -6
- package/src/cooperation/merge.ts +0 -190
- package/src/cooperation/metrics.ts +0 -57
- package/src/cooperation/session.ts +0 -131
- package/src/cooperation/unified.ts +0 -56
- package/src/counter.ts +0 -9
- package/src/database/adapter/adapters.ts +0 -35
- package/src/database/adapter/index.ts +0 -4
- package/src/database/adapter/runtimeSink.ts +0 -74
- package/src/database/adapter/sessionStore.ts +0 -32
- package/src/database/adapter/turnStore.ts +0 -23
- package/src/database/entity/agent.ts +0 -199
- package/src/database/entity/entity.ts +0 -1046
- package/src/database/entity/handle.ts +0 -79
- package/src/database/entity/index.ts +0 -32
- package/src/database/entity/message.ts +0 -74
- package/src/database/entity/meta.ts +0 -11
- package/src/database/entity/object.ts +0 -42
- package/src/database/entity/outbox.ts +0 -15
- package/src/database/entity/process.ts +0 -65
- package/src/database/entity/registry.ts +0 -155
- package/src/database/entity/runtimeApproval.ts +0 -30
- package/src/database/entity/runtimeSession.ts +0 -13
- package/src/database/entity/runtimeTurn.ts +0 -15
- package/src/database/entity/thread.ts +0 -85
- package/src/database/entity/window.ts +0 -85
- package/src/database/entity/worker.ts +0 -90
- package/src/database/index.ts +0 -6
- package/src/database/repository/addressSpaceRepository.ts +0 -72
- package/src/database/repository/agentRepository.ts +0 -460
- package/src/database/repository/base.ts +0 -41
- package/src/database/repository/executionRepository.ts +0 -477
- package/src/database/repository/handleRepository.ts +0 -64
- package/src/database/repository/index.ts +0 -20
- package/src/database/repository/messageRepository.ts +0 -52
- package/src/database/repository/objectRepository.ts +0 -69
- package/src/database/repository/outboxRepository.ts +0 -63
- package/src/database/repository/processRepository.ts +0 -58
- package/src/database/repository/registryRepository.ts +0 -119
- package/src/database/repository/repository.ts +0 -491
- package/src/database/repository/runtimeApprovalRepository.ts +0 -44
- package/src/database/repository/runtimeSessionRepository.ts +0 -27
- package/src/database/repository/runtimeTurnRepository.ts +0 -39
- package/src/database/repository/socialRepository.ts +0 -185
- package/src/database/repository/threadRepository.ts +0 -57
- package/src/database/repository/windowRepository.ts +0 -88
- package/src/database/repository/workerRepository.ts +0 -69
- package/src/database/service/database.ts +0 -90
- package/src/database/service/handleService.ts +0 -48
- package/src/database/service/index.ts +0 -16
- package/src/database/service/messageService.ts +0 -61
- package/src/database/service/objectService.ts +0 -59
- package/src/database/service/processService.ts +0 -61
- package/src/database/service/registryServices.ts +0 -88
- package/src/database/service/service.ts +0 -183
- package/src/database/service/stepService.ts +0 -53
- package/src/database/service/threadService.ts +0 -65
- package/src/database/service/windowService.ts +0 -30
- package/src/database/service/workerService.ts +0 -57
- package/src/database/sql/index.ts +0 -3
- package/src/database/sql/schema.ts +0 -418
- package/src/database/sql/sql.ts +0 -543
- package/src/database/store/database.ts +0 -210
- package/src/database/store/index.ts +0 -3
- package/src/database/store/store.ts +0 -266
- package/src/delegate/index.ts +0 -2
- package/src/delegate/team.ts +0 -268
- package/src/delegate/teamTypes.ts +0 -47
- package/src/diagnosis/checklist.ts +0 -74
- package/src/diagnosis/context.ts +0 -93
- package/src/diagnosis/frame.ts +0 -256
- package/src/diagnosis/index.ts +0 -5
- package/src/diagnosis/router.ts +0 -72
- package/src/diagnosis/types.ts +0 -89
- package/src/error/agentError.ts +0 -16
- package/src/error/ampError.ts +0 -20
- package/src/error/authzError.ts +0 -14
- package/src/error/boundaryRejection.ts +0 -20
- package/src/error/index.ts +0 -7
- package/src/error/kernelError.ts +0 -27
- package/src/error/mailboxError.ts +0 -9
- package/src/error/windowError.ts +0 -12
- package/src/evaluation/agreement.ts +0 -96
- package/src/evaluation/index.ts +0 -2
- package/src/evaluation/labels.ts +0 -241
- package/src/evidence/evidenceGraph.ts +0 -205
- package/src/evidence/index.ts +0 -4
- package/src/evidence/revalidation.ts +0 -191
- package/src/execution/exec.ts +0 -408
- package/src/execution/handles.ts +0 -65
- package/src/execution/index.ts +0 -3
- package/src/execution/pin.ts +0 -154
- package/src/frame/frame.ts +0 -70
- package/src/frame/index.ts +0 -1
- package/src/goal/goal.ts +0 -43
- package/src/goal/index.ts +0 -2
- package/src/goal/plan.ts +0 -196
- package/src/governance/attentionManifest.ts +0 -802
- package/src/governance/audit.ts +0 -362
- package/src/governance/budget.ts +0 -628
- package/src/governance/context.ts +0 -356
- package/src/governance/control.ts +0 -159
- package/src/governance/cooperation.ts +0 -479
- package/src/governance/credential.ts +0 -359
- package/src/governance/httpServer.ts +0 -99
- package/src/governance/index.ts +0 -32
- package/src/governance/legal.ts +0 -574
- package/src/governance/matrix.ts +0 -460
- package/src/governance/perspectives.ts +0 -406
- package/src/governance/signing.ts +0 -407
- package/src/governance/store.ts +0 -125
- package/src/governance/switching.ts +0 -459
- package/src/governance/toolPolicy.ts +0 -80
- package/src/governance/transport.ts +0 -204
- package/src/governance/types.ts +0 -380
- package/src/governance/workflow.ts +0 -743
- package/src/index.ts +0 -11
- package/src/interaction/index.ts +0 -1
- package/src/interaction/interaction.ts +0 -391
- package/src/ipc/index.ts +0 -4
- package/src/ipc/mailbox.ts +0 -132
- package/src/ipc/memorySocialStore.ts +0 -93
- package/src/ipc/social.ts +0 -93
- package/src/kernel/index.ts +0 -14
- package/src/kernel/scheduler.ts +0 -498
- package/src/ledger/checkpoint.ts +0 -304
- package/src/ledger/index.ts +0 -4
- package/src/ledger/ledger.ts +0 -31
- package/src/ledger/persistence.ts +0 -159
- package/src/ledger/share.ts +0 -80
- package/src/lock/index.ts +0 -2
- package/src/lock/lease.ts +0 -74
- package/src/main.ts +0 -199
- package/src/manifest/agentCard.ts +0 -72
- package/src/manifest/cardSign.ts +0 -87
- package/src/manifest/federation.ts +0 -237
- package/src/manifest/federationTypes.ts +0 -55
- package/src/manifest/index.ts +0 -8
- package/src/manifest/keys.ts +0 -643
- package/src/manifest/manifest.ts +0 -114
- package/src/manifest/sign.ts +0 -134
- package/src/manifest/trust.ts +0 -146
- package/src/mission/index.ts +0 -2
- package/src/mission/missionQueue.ts +0 -75
- package/src/module/index.ts +0 -9
- package/src/module/llm/deepseek.ts +0 -214
- package/src/module/llm/llm.ts +0 -84
- package/src/module/mcp/client.ts +0 -110
- package/src/module/mcp/http.ts +0 -102
- package/src/module/mcp/protocol.ts +0 -77
- package/src/module/mcp/server.ts +0 -148
- package/src/module/mcp/transport.ts +0 -30
- package/src/module/mcp/workspaceServer.ts +0 -111
- package/src/module/sandbox/sandbox.ts +0 -29
- package/src/module/tool/mcpExecutor.ts +0 -54
- package/src/module/tool/policy.ts +0 -52
- package/src/module/tool/redact.ts +0 -29
- package/src/module/tool/tool.ts +0 -53
- package/src/module/tool/workspaceExecutor.ts +0 -35
- package/src/policy/guard.ts +0 -240
- package/src/policy/index.ts +0 -2
- package/src/policy/policy.ts +0 -561
- package/src/process/agent.ts +0 -341
- package/src/process/agentService.ts +0 -236
- package/src/process/agentStore.ts +0 -378
- package/src/process/executionStore.ts +0 -151
- package/src/process/index.ts +0 -5
- package/src/process/process.ts +0 -240
- package/src/process/transitions.ts +0 -19
- package/src/progress/index.ts +0 -2
- package/src/progress/progress.ts +0 -85
- package/src/protocol/a2a.ts +0 -120
- package/src/protocol/channel.ts +0 -44
- package/src/protocol/envelope.ts +0 -655
- package/src/protocol/httpChannel.ts +0 -87
- package/src/protocol/index.ts +0 -6
- package/src/protocol/protocol.ts +0 -138
- package/src/protocol/wire.ts +0 -60
- package/src/receipt/index.ts +0 -1
- package/src/receipt/receipt.ts +0 -47
- package/src/registry/content.ts +0 -69
- package/src/registry/index.ts +0 -23
- package/src/registry/registry.ts +0 -599
- package/src/runtime/action.ts +0 -87
- package/src/runtime/behavior.ts +0 -330
- package/src/runtime/behaviorTuning.ts +0 -163
- package/src/runtime/cognitiveRuntime.ts +0 -703
- package/src/runtime/escalation.ts +0 -35
- package/src/runtime/governedTask.ts +0 -233
- package/src/runtime/index.ts +0 -15
- package/src/runtime/kernelRuntime.ts +0 -144
- package/src/runtime/operation.ts +0 -35
- package/src/runtime/replay.ts +0 -71
- package/src/runtime/routing.ts +0 -58
- package/src/runtime/safety.ts +0 -48
- package/src/runtime/session.ts +0 -341
- package/src/runtime/sessionStore.ts +0 -43
- package/src/runtime/telemetry.ts +0 -55
- package/src/runtime/turnStore.ts +0 -30
- package/src/scenario/index.ts +0 -1
- package/src/scenario/scenario.ts +0 -299
- package/src/semantic/canonical.ts +0 -24
- package/src/semantic/index.ts +0 -2
- package/src/semantic/sha256.ts +0 -82
- package/src/storage/appendLog.ts +0 -372
- package/src/storage/fileAppendSink.ts +0 -40
- package/src/storage/index.ts +0 -2
- package/src/store/bindCache.ts +0 -22
- package/src/store/cache.ts +0 -191
- package/src/store/context.ts +0 -31
- package/src/store/handleStore.ts +0 -31
- package/src/store/index.ts +0 -9
- package/src/store/messageStore.ts +0 -31
- package/src/store/objectStore.ts +0 -31
- package/src/store/processStore.ts +0 -31
- package/src/store/threadStore.ts +0 -31
- package/src/store/windowStore.ts +0 -31
- package/src/structure/abstractSyntaxTree.ts +0 -493
- package/src/structure/avlTree.ts +0 -408
- package/src/structure/binarySearchTree.ts +0 -352
- package/src/structure/binaryTree.ts +0 -525
- package/src/structure/bloomFilter.ts +0 -231
- package/src/structure/compare.ts +0 -110
- package/src/structure/cuckooFilter.ts +0 -337
- package/src/structure/deque.ts +0 -223
- package/src/structure/filterKey.ts +0 -36
- package/src/structure/hash.ts +0 -279
- package/src/structure/heap.ts +0 -268
- package/src/structure/index.ts +0 -20
- package/src/structure/iterator.ts +0 -22
- package/src/structure/lru.ts +0 -619
- package/src/structure/ordered.ts +0 -399
- package/src/structure/priority.ts +0 -915
- package/src/structure/queue.ts +0 -168
- package/src/structure/redBlackTree.ts +0 -680
- package/src/structure/segmentTree.ts +0 -248
- package/src/structure/stack.ts +0 -118
- package/src/structure/unordered.ts +0 -407
- package/src/style.css +0 -278
- package/src/thread/index.ts +0 -2
- package/src/thread/thread.ts +0 -176
- package/src/thread/transitions.ts +0 -17
- package/src/types/common.ts +0 -119
- package/src/types/index.ts +0 -23
- package/src/warrant/epistemic.ts +0 -154
- package/src/warrant/index.ts +0 -3
- package/src/warrant/inquiry.ts +0 -166
- package/src/warrant/warrant.ts +0 -179
- package/src/window/compaction.ts +0 -403
- package/src/window/compactionTypes.ts +0 -119
- package/src/window/index.ts +0 -7
- package/src/window/page.ts +0 -18
- package/src/window/window.ts +0 -244
- package/tools/_helpers.ts +0 -34
- package/tools/a2a-check.ts +0 -110
- package/tools/a2a-flow-check.ts +0 -78
- package/tools/agent-card-check.ts +0 -76
- package/tools/agent-check.ts +0 -236
- package/tools/agent-store-check.ts +0 -153
- package/tools/agreement-check.ts +0 -27
- package/tools/annotation-server-check.ts +0 -48
- package/tools/annotation-server.ts +0 -230
- package/tools/annotation-status.ts +0 -65
- package/tools/approval-access-check.ts +0 -66
- package/tools/arch-check.ts +0 -72
- package/tools/attention-core-check.ts +0 -48
- package/tools/attention-resource-check.ts +0 -169
- package/tools/audit-check.ts +0 -207
- package/tools/authority-check.ts +0 -124
- package/tools/authz-check.ts +0 -138
- package/tools/bayes-check.ts +0 -162
- package/tools/bayes-probe.ts +0 -154
- package/tools/behavior-tuning-check.ts +0 -53
- package/tools/board-check.ts +0 -87
- package/tools/boundary-check.ts +0 -199
- package/tools/bundle-trust-check.ts +0 -96
- package/tools/calibrate-imported.ts +0 -108
- package/tools/calibration-check.ts +0 -44
- package/tools/calibration-registry-check.ts +0 -40
- package/tools/calibration-sim.ts +0 -40
- package/tools/card-sign-check.ts +0 -71
- package/tools/card-trust-check.ts +0 -78
- package/tools/channel-check.ts +0 -86
- package/tools/checkpoint-check.ts +0 -620
- package/tools/cleanup-style-configs.ts +0 -29
- package/tools/cognition-check.ts +0 -648
- package/tools/cognitive-runtime-check.ts +0 -609
- package/tools/collaboration-demo.ts +0 -78
- package/tools/compaction-check.ts +0 -266
- package/tools/concept-check.ts +0 -260
- package/tools/concurrency-check.ts +0 -242
- package/tools/conformance-runtime.ts +0 -389
- package/tools/conformance.ts +0 -651
- package/tools/context-ast-check.ts +0 -90
- package/tools/context-ast-deepseek.ts +0 -242
- package/tools/context-graph-bench.ts +0 -50
- package/tools/context-graph-check.ts +0 -229
- package/tools/context-index-check.ts +0 -48
- package/tools/context-lifecycle-check.ts +0 -69
- package/tools/context-projection-check.ts +0 -73
- package/tools/context-scope-check.ts +0 -134
- package/tools/context-storage-check.ts +0 -113
- package/tools/cooperation-check.ts +0 -517
- package/tools/cooperation-http-check.ts +0 -125
- package/tools/deepseek-llm-check.ts +0 -147
- package/tools/deepseek-probe.ts +0 -494
- package/tools/diagnosis-check.ts +0 -109
- package/tools/diagnosis-router-check.ts +0 -50
- package/tools/document-context-check.ts +0 -237
- package/tools/envelope-check.ts +0 -659
- package/tools/eslint-rules/index.ts +0 -26
- package/tools/eslint-rules/rules/jsdoc-comment-format.ts +0 -105
- package/tools/eslint-rules/rules/no-function-keyword.ts +0 -60
- package/tools/eslint-rules/rules/no-multiline-parameters.ts +0 -71
- package/tools/eslint-rules/rules/no-multiline-type-parameters.ts +0 -57
- package/tools/eslint-rules/rules/no-undefined-comparison.ts +0 -115
- package/tools/eslint-rules/rules/prefer-template-for-string-conversion.ts +0 -97
- package/tools/eslint-rules/rules/require-typeof-parentheses.ts +0 -49
- package/tools/eslint-rules/rules/require-variable-type.ts +0 -36
- package/tools/eslint-rules/rules/variable-naming.ts +0 -175
- package/tools/eval-recorded-replay.ts +0 -215
- package/tools/eval-replay.ts +0 -139
- package/tools/eval-summary.ts +0 -136
- package/tools/evidence-revalidation-check.ts +0 -235
- package/tools/exec-check.ts +0 -217
- package/tools/federation-check.ts +0 -166
- package/tools/federation-demo.ts +0 -45
- package/tools/filter-check.ts +0 -243
- package/tools/governance-check.ts +0 -680
- package/tools/governance-store-check.ts +0 -131
- package/tools/governed-task-check.ts +0 -227
- package/tools/guard-check.ts +0 -122
- package/tools/http-channel-check.ts +0 -125
- package/tools/import-campaign.ts +0 -28
- package/tools/inquiry-check.ts +0 -126
- package/tools/interaction-check.ts +0 -171
- package/tools/interrupts-check.ts +0 -173
- package/tools/ipc-check.ts +0 -170
- package/tools/kernel-async-check.ts +0 -136
- package/tools/kernel-check.ts +0 -369
- package/tools/kernel-runtime-check.ts +0 -276
- package/tools/keys-check.ts +0 -559
- package/tools/label-audit.ts +0 -70
- package/tools/labels-workflow-check.ts +0 -49
- package/tools/linear-structure-check.ts +0 -524
- package/tools/live-exec.ts +0 -62
- package/tools/live-governance-eval.ts +0 -813
- package/tools/live-legacy.ts +0 -50
- package/tools/lru-check.ts +0 -182
- package/tools/make-annotation-campaign.ts +0 -57
- package/tools/mcp-executor-check.ts +0 -33
- package/tools/merge-annotations.ts +0 -32
- package/tools/merge-check.ts +0 -98
- package/tools/metrics-check.ts +0 -84
- package/tools/net-probe.ts +0 -107
- package/tools/oauth-probe.ts +0 -117
- package/tools/outbox-check.ts +0 -50
- package/tools/persistence-check.ts +0 -144
- package/tools/pin-check.ts +0 -116
- package/tools/platform-check.ts +0 -281
- package/tools/policy-check.ts +0 -514
- package/tools/prettier-plugin/index.mts +0 -84
- package/tools/priority-check.ts +0 -627
- package/tools/probe-context7.ts +0 -63
- package/tools/registry-check.ts +0 -252
- package/tools/reliability-check.ts +0 -25
- package/tools/retry-check.ts +0 -85
- package/tools/rewrite-declaration-extensions.ts +0 -98
- package/tools/runtime-check.ts +0 -165
- package/tools/runtime-deepseek-check.ts +0 -85
- package/tools/runtime-eval.ts +0 -358
- package/tools/scenario-check.ts +0 -161
- package/tools/scenario-incident.ts +0 -162
- package/tools/scoped-priors-check.ts +0 -35
- package/tools/scoped-priors-pooling.ts +0 -34
- package/tools/segment-ast-check.ts +0 -649
- package/tools/session-check.ts +0 -196
- package/tools/session-store-check.ts +0 -73
- package/tools/share-check.ts +0 -88
- package/tools/sign-check.ts +0 -95
- package/tools/signing-check.ts +0 -275
- package/tools/snapshot-demo.ts +0 -65
- package/tools/social-check.ts +0 -146
- package/tools/structure-compare-check.ts +0 -95
- package/tools/support/documentScanner.ts +0 -577
- package/tools/support/texScanner.ts +0 -631
- package/tools/support/workspaceScanner.ts +0 -476
- package/tools/team-check.ts +0 -163
- package/tools/team-demo.ts +0 -36
- package/tools/telemetry-check.ts +0 -44
- package/tools/tex-context-check.ts +0 -263
- package/tools/tool-gate-check.ts +0 -98
- package/tools/tree-structure-check.ts +0 -786
- package/tools/trust-flow-check.ts +0 -158
- package/tools/turn-store-check.ts +0 -57
- package/tools/unified-check.ts +0 -83
- package/tools/validate.ts +0 -309
- package/tools/wire-check.ts +0 -96
- package/tools/workspace-agent-check.ts +0 -486
- package/tools/workspace-agent-demo.ts +0 -62
- package/tools/workspace-agent-server.ts +0 -101
- package/tools/workspace-context-check.ts +0 -331
- package/tools/workspace-context.ts +0 -131
- package/tsconfig.build.json +0 -14
- package/tsconfig.json +0 -24
- package/tsconfig.tools.json +0 -31
- package/viz/context-ast.json +0 -1577
|
@@ -0,0 +1,1070 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* React outline support.
|
|
3
|
+
*
|
|
4
|
+
* A `.jsx`/`.tsx` file is still TypeScript/JavaScript at the declaration level,
|
|
5
|
+
* so this strategy wraps `parseTypeScript` instead of re-implementing the
|
|
6
|
+
* declaration scanner: that scanner already masks comments, strings, template
|
|
7
|
+
* literals and regular-expression literals, nests class members and reports
|
|
8
|
+
* line ranges. `parseReact` then adds the React meaning on top of that tree:
|
|
9
|
+
*
|
|
10
|
+
* - a class declared with `extends React.Component` / `React.PureComponent`
|
|
11
|
+
* becomes `component`;
|
|
12
|
+
* - an upper-case function/arrow that returns JSX, or a `React.memo` /
|
|
13
|
+
* `React.forwardRef` wrapper around one, becomes `component`;
|
|
14
|
+
* - every hook call (`useState`, `useEffect`, `useMemo`, `useCallback`,
|
|
15
|
+
* `useRef`, `useContext`, `useReducer` and any custom `useX`) becomes one
|
|
16
|
+
* `hook` node per name, deduplicated file-wide;
|
|
17
|
+
* - `interface XProps` / `type XProps` become `props`;
|
|
18
|
+
* - upper-case JSX tags used inside a component become `jsx` children.
|
|
19
|
+
*
|
|
20
|
+
* The shared `OutlineKind` union lives in `types.ts` and is not widened here,
|
|
21
|
+
* so the React-only kinds are local string literals converted at the single
|
|
22
|
+
* emission point (`outlineTypeOf`). The registry copies `type` through
|
|
23
|
+
* unchanged, so a caller sees `"component"` / `"hook"` / `"props"` / `"jsx"`
|
|
24
|
+
* on the node; a renderer that exhaustively switches on `OutlineKind` needs
|
|
25
|
+
* the union extended (see `docs/testing/languages/reactReport.md`).
|
|
26
|
+
*
|
|
27
|
+
* Selection is extension-gated and evidence-gated: only `.jsx`/`.tsx` files
|
|
28
|
+
* whose head contains React evidence are claimed. A plain `.tsx` file with no
|
|
29
|
+
* React evidence is left to the TypeScript strategy, which is why the React
|
|
30
|
+
* strategy must be registered *before* the TypeScript/JavaScript strategies
|
|
31
|
+
* (both also claim `.tsx`/`.jsx`; registration order is selection order).
|
|
32
|
+
*
|
|
33
|
+
* The parser is a bounded scanner, not a JSX grammar: it reuses the TypeScript
|
|
34
|
+
* declaration tree, masks the source once more for hook/JSX evidence, and
|
|
35
|
+
* bounds every forward scan. It never touches the filesystem and never throws
|
|
36
|
+
* on malformed input.
|
|
37
|
+
*/
|
|
38
|
+
import { ByteLineIndex } from "../syntax/byteIndex.js";
|
|
39
|
+
import { LineIndex } from "../syntax/charset.js";
|
|
40
|
+
import { parseTypeScript } from "./outlineStrategies.js";
|
|
41
|
+
/**
|
|
42
|
+
* React hook names that are part of the React API. Every one of them also
|
|
43
|
+
* matches the generic `use[A-Z]` convention, so the list is a contract for
|
|
44
|
+
* callers/tests rather than a detection shortcut.
|
|
45
|
+
*/
|
|
46
|
+
export const BuiltinReactHooks = new Set([
|
|
47
|
+
"useState",
|
|
48
|
+
"useEffect",
|
|
49
|
+
"useMemo",
|
|
50
|
+
"useCallback",
|
|
51
|
+
"useRef",
|
|
52
|
+
"useContext",
|
|
53
|
+
"useReducer",
|
|
54
|
+
]);
|
|
55
|
+
/**
|
|
56
|
+
* Extensions this strategy owns. The TypeScript strategy also claims `.tsx`
|
|
57
|
+
* and the JavaScript strategy `.jsx`, so registration order decides the
|
|
58
|
+
* winner; this strategy only matches when React evidence is present.
|
|
59
|
+
*/
|
|
60
|
+
const ReactExtensions = [".tsx", ".jsx"];
|
|
61
|
+
/**
|
|
62
|
+
* Head evidence for "this file is a React module". The patterns deliberately
|
|
63
|
+
* mirror the documented contract: a `react` import/require, a `React.` member
|
|
64
|
+
* access, a `jsx` pragma/word, or an upper-case JSX tag.
|
|
65
|
+
*/
|
|
66
|
+
const ReactEvidence = [
|
|
67
|
+
/\bfrom\s+["']react["']/,
|
|
68
|
+
/\brequire\s*\(\s*["']react["']\s*\)/,
|
|
69
|
+
/\bReact\s*\./,
|
|
70
|
+
/@jsx\b/i,
|
|
71
|
+
/(?<![\p{ID_Continue}$.])<\s*\p{Lu}[\p{ID_Continue}$.]+(?=[\s/>])/u,
|
|
72
|
+
];
|
|
73
|
+
/**
|
|
74
|
+
* Characters after which a `/` opens a regular-expression literal rather than
|
|
75
|
+
* dividing. The set is the usual expression-prefix heuristic.
|
|
76
|
+
*/
|
|
77
|
+
const RegexPrefixCharacters = "([{=,:;!&|?+-*%^~<>";
|
|
78
|
+
/**
|
|
79
|
+
* Keywords after which a `/` opens a regular-expression literal.
|
|
80
|
+
*/
|
|
81
|
+
const RegexPrefixKeywords = new Set([
|
|
82
|
+
"return",
|
|
83
|
+
"typeof",
|
|
84
|
+
"instanceof",
|
|
85
|
+
"case",
|
|
86
|
+
"in",
|
|
87
|
+
"of",
|
|
88
|
+
"delete",
|
|
89
|
+
"void",
|
|
90
|
+
"new",
|
|
91
|
+
"do",
|
|
92
|
+
"else",
|
|
93
|
+
"yield",
|
|
94
|
+
"await",
|
|
95
|
+
"throw",
|
|
96
|
+
]);
|
|
97
|
+
/**
|
|
98
|
+
* Previous non-whitespace character before an offset.
|
|
99
|
+
*/
|
|
100
|
+
const significantBefore = (text, index) => {
|
|
101
|
+
for (let cursor = index - 1; cursor >= 0; cursor -= 1) {
|
|
102
|
+
const character = text[cursor];
|
|
103
|
+
if (!/\s/.test(character)) {
|
|
104
|
+
return character;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
return "";
|
|
108
|
+
};
|
|
109
|
+
/**
|
|
110
|
+
* Whether a `/` at one offset may open a regular-expression literal.
|
|
111
|
+
*/
|
|
112
|
+
const regexAllowed = (text, index) => {
|
|
113
|
+
const before = significantBefore(text, index);
|
|
114
|
+
if (before.length === 0 || RegexPrefixCharacters.includes(before) || before === "}") {
|
|
115
|
+
return true;
|
|
116
|
+
}
|
|
117
|
+
if (/[A-Za-z0-9_$]/.test(before)) {
|
|
118
|
+
const prefix = text.slice(Math.max(0, index - 64), index);
|
|
119
|
+
const match = /([A-Za-z_$][\w$]*)\s*$/.exec(prefix);
|
|
120
|
+
return match !== null && RegexPrefixKeywords.has(match[1]);
|
|
121
|
+
}
|
|
122
|
+
return false;
|
|
123
|
+
};
|
|
124
|
+
/**
|
|
125
|
+
* Characters after which a quote opens a JavaScript string literal: an
|
|
126
|
+
* expression is expected.
|
|
127
|
+
*/
|
|
128
|
+
const StringPrefixCharacters = "([{=,:;!&|?+-*%^~<>";
|
|
129
|
+
/**
|
|
130
|
+
* Keywords after which a quote opens a string literal. Module specifiers are
|
|
131
|
+
* included so `from "react"` is masked.
|
|
132
|
+
*/
|
|
133
|
+
const StringPrefixKeywords = new Set([
|
|
134
|
+
"return",
|
|
135
|
+
"case",
|
|
136
|
+
"throw",
|
|
137
|
+
"typeof",
|
|
138
|
+
"instanceof",
|
|
139
|
+
"in",
|
|
140
|
+
"of",
|
|
141
|
+
"new",
|
|
142
|
+
"delete",
|
|
143
|
+
"void",
|
|
144
|
+
"yield",
|
|
145
|
+
"await",
|
|
146
|
+
"do",
|
|
147
|
+
"else",
|
|
148
|
+
"import",
|
|
149
|
+
"export",
|
|
150
|
+
"from",
|
|
151
|
+
"default",
|
|
152
|
+
"const",
|
|
153
|
+
"let",
|
|
154
|
+
"var",
|
|
155
|
+
"as",
|
|
156
|
+
"satisfies",
|
|
157
|
+
"keyof",
|
|
158
|
+
]);
|
|
159
|
+
/**
|
|
160
|
+
* Whether a quote at one offset opens a JavaScript string literal.
|
|
161
|
+
*
|
|
162
|
+
* JSX text is not JavaScript string syntax. A prose apostrophe (`don't`) or a
|
|
163
|
+
* quoted phrase in a tag body must not start a mask, otherwise the rest of the
|
|
164
|
+
* line (including a nested `<Widget />`) disappears from the evidence scan. A
|
|
165
|
+
* quote is therefore honored only in expression position: after an operator or
|
|
166
|
+
* an opening bracket, after a `return`-like keyword, or, for a module
|
|
167
|
+
* specifier, after `from`/`import`. A quote directly after an identifier is
|
|
168
|
+
* prose and stays visible.
|
|
169
|
+
*
|
|
170
|
+
* @param text - Raw source text.
|
|
171
|
+
* @param index - Offset of the quote.
|
|
172
|
+
* @returns Whether the quote starts a string literal.
|
|
173
|
+
*/
|
|
174
|
+
const stringAllowed = (text, index) => {
|
|
175
|
+
const before = significantBefore(text, index);
|
|
176
|
+
if (before.length === 0 || StringPrefixCharacters.includes(before)) {
|
|
177
|
+
return true;
|
|
178
|
+
}
|
|
179
|
+
if (/[A-Za-z0-9_$]/.test(before)) {
|
|
180
|
+
const prefix = text.slice(Math.max(0, index - 64), index);
|
|
181
|
+
const match = /([A-Za-z_$][\w$]*)\s*$/.exec(prefix);
|
|
182
|
+
return match !== null && StringPrefixKeywords.has(match[1]);
|
|
183
|
+
}
|
|
184
|
+
return false;
|
|
185
|
+
};
|
|
186
|
+
/**
|
|
187
|
+
* Replace a range with spaces, preserving `\n` so line numbers stay valid.
|
|
188
|
+
*/
|
|
189
|
+
const blankMaskRange = (context, from, to) => {
|
|
190
|
+
const stop = Math.min(to, context.length);
|
|
191
|
+
for (let cursor = from; cursor < stop; cursor += 1) {
|
|
192
|
+
context.characters[cursor] = context.text[cursor] === "\n" ? "\n" : " ";
|
|
193
|
+
}
|
|
194
|
+
};
|
|
195
|
+
/**
|
|
196
|
+
* Mask one template literal, leaving `${...}` expressions as code.
|
|
197
|
+
*
|
|
198
|
+
* Template text is string content and is blanked; the expression inside a
|
|
199
|
+
* placeholder is real source, so a hook call there (`${useMemo(...)}`) is still
|
|
200
|
+
* visible to the hook scanner. Nested templates recurse.
|
|
201
|
+
*
|
|
202
|
+
* @param context - Masking state.
|
|
203
|
+
* @param index - Offset of the opening backtick.
|
|
204
|
+
* @returns Offset just past the closing backtick (or the end of the text).
|
|
205
|
+
*/
|
|
206
|
+
const maskTemplateLiteral = (context, index) => {
|
|
207
|
+
const text = context.text;
|
|
208
|
+
const length = context.length;
|
|
209
|
+
blankMaskRange(context, index, index + 1);
|
|
210
|
+
let cursor = index + 1;
|
|
211
|
+
while (cursor < length) {
|
|
212
|
+
const character = text[cursor];
|
|
213
|
+
if (character === "\\") {
|
|
214
|
+
blankMaskRange(context, cursor, cursor + 2);
|
|
215
|
+
cursor += 2;
|
|
216
|
+
continue;
|
|
217
|
+
}
|
|
218
|
+
if (character === "`") {
|
|
219
|
+
blankMaskRange(context, cursor, cursor + 1);
|
|
220
|
+
return cursor + 1;
|
|
221
|
+
}
|
|
222
|
+
if (character === "$" && text[cursor + 1] === "{") {
|
|
223
|
+
blankMaskRange(context, cursor, cursor + 2);
|
|
224
|
+
const close = scanCodeMask(context, cursor + 2, true);
|
|
225
|
+
if (close < length) {
|
|
226
|
+
blankMaskRange(context, close, close + 1);
|
|
227
|
+
cursor = close + 1;
|
|
228
|
+
}
|
|
229
|
+
else {
|
|
230
|
+
cursor = length;
|
|
231
|
+
}
|
|
232
|
+
continue;
|
|
233
|
+
}
|
|
234
|
+
blankMaskRange(context, cursor, cursor + 1);
|
|
235
|
+
cursor += 1;
|
|
236
|
+
}
|
|
237
|
+
return length;
|
|
238
|
+
};
|
|
239
|
+
/**
|
|
240
|
+
* Scan code and blank comments, strings, template literals and regular
|
|
241
|
+
* expression literals.
|
|
242
|
+
*
|
|
243
|
+
* @param context - Masking state.
|
|
244
|
+
* @param index - Offset to start at.
|
|
245
|
+
* @param stopAtBrace - When set, return at the `}` that closes the current
|
|
246
|
+
* `${...}` expression instead of scanning past it.
|
|
247
|
+
* @returns Offset of the stopping `}` (when `stopAtBrace`), or the end.
|
|
248
|
+
*/
|
|
249
|
+
const scanCodeMask = (context, index, stopAtBrace) => {
|
|
250
|
+
const text = context.text;
|
|
251
|
+
const length = context.length;
|
|
252
|
+
let cursor = index;
|
|
253
|
+
let depth = 0;
|
|
254
|
+
while (cursor < length) {
|
|
255
|
+
const character = text[cursor];
|
|
256
|
+
if (stopAtBrace) {
|
|
257
|
+
if (character === "{") {
|
|
258
|
+
depth += 1;
|
|
259
|
+
cursor += 1;
|
|
260
|
+
continue;
|
|
261
|
+
}
|
|
262
|
+
if (character === "}") {
|
|
263
|
+
if (depth === 0) {
|
|
264
|
+
return cursor;
|
|
265
|
+
}
|
|
266
|
+
depth -= 1;
|
|
267
|
+
cursor += 1;
|
|
268
|
+
continue;
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
if (character === "/" && text[cursor + 1] === "/") {
|
|
272
|
+
/**
|
|
273
|
+
* A URL inside JSX text (`https://example.test`) is prose, not a
|
|
274
|
+
* line comment; a scheme directly before `//` is the guard.
|
|
275
|
+
*/
|
|
276
|
+
const scheme = /[A-Za-z][A-Za-z0-9+.-]*:\/\/$/.test(text.slice(Math.max(0, cursor - 40), cursor + 2));
|
|
277
|
+
if (!scheme) {
|
|
278
|
+
const newline = text.indexOf("\n", cursor);
|
|
279
|
+
const stop = newline === -1 ? length : newline;
|
|
280
|
+
blankMaskRange(context, cursor, stop);
|
|
281
|
+
cursor = stop;
|
|
282
|
+
continue;
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
if (character === "/" && text[cursor + 1] === "*") {
|
|
286
|
+
const end = text.indexOf("*/", cursor + 2);
|
|
287
|
+
const stop = end === -1 ? length : end + 2;
|
|
288
|
+
blankMaskRange(context, cursor, stop);
|
|
289
|
+
cursor = stop;
|
|
290
|
+
continue;
|
|
291
|
+
}
|
|
292
|
+
if ((character === '"' || character === "'") && stringAllowed(text, cursor)) {
|
|
293
|
+
let next = cursor + 1;
|
|
294
|
+
while (next < length) {
|
|
295
|
+
const current = text[next];
|
|
296
|
+
if (current === "\\") {
|
|
297
|
+
next += 2;
|
|
298
|
+
continue;
|
|
299
|
+
}
|
|
300
|
+
if (current === character) {
|
|
301
|
+
next += 1;
|
|
302
|
+
break;
|
|
303
|
+
}
|
|
304
|
+
if (current === "\n") {
|
|
305
|
+
break;
|
|
306
|
+
}
|
|
307
|
+
next += 1;
|
|
308
|
+
}
|
|
309
|
+
blankMaskRange(context, cursor, next);
|
|
310
|
+
cursor = next;
|
|
311
|
+
continue;
|
|
312
|
+
}
|
|
313
|
+
if (character === "`") {
|
|
314
|
+
cursor = maskTemplateLiteral(context, cursor);
|
|
315
|
+
continue;
|
|
316
|
+
}
|
|
317
|
+
if (character === "/" && regexAllowed(text, cursor)) {
|
|
318
|
+
let next = cursor + 1;
|
|
319
|
+
let inClass = false;
|
|
320
|
+
let closed = false;
|
|
321
|
+
while (next < length) {
|
|
322
|
+
const current = text[next];
|
|
323
|
+
if (current === "\\") {
|
|
324
|
+
next += 2;
|
|
325
|
+
continue;
|
|
326
|
+
}
|
|
327
|
+
if (current === "\n") {
|
|
328
|
+
break;
|
|
329
|
+
}
|
|
330
|
+
if (current === "[") {
|
|
331
|
+
inClass = true;
|
|
332
|
+
}
|
|
333
|
+
else if (current === "]") {
|
|
334
|
+
inClass = false;
|
|
335
|
+
}
|
|
336
|
+
else if (current === "/" && !inClass) {
|
|
337
|
+
next += 1;
|
|
338
|
+
closed = true;
|
|
339
|
+
break;
|
|
340
|
+
}
|
|
341
|
+
next += 1;
|
|
342
|
+
}
|
|
343
|
+
if (closed) {
|
|
344
|
+
blankMaskRange(context, cursor, next);
|
|
345
|
+
cursor = next;
|
|
346
|
+
continue;
|
|
347
|
+
}
|
|
348
|
+
}
|
|
349
|
+
cursor += 1;
|
|
350
|
+
}
|
|
351
|
+
return length;
|
|
352
|
+
};
|
|
353
|
+
/**
|
|
354
|
+
* Mask comments, strings, template literals and regular-expression literals
|
|
355
|
+
* while preserving every offset and line break.
|
|
356
|
+
*
|
|
357
|
+
* The wrapped `parseTypeScript` masks the source internally but does not export
|
|
358
|
+
* the masked text, and hook/JSX evidence must not be read out of a comment or a
|
|
359
|
+
* string. The scanner keeps one string of the same length; unterminated
|
|
360
|
+
* constructs run to the end of the text instead of throwing, because an
|
|
361
|
+
* outline of a half-written file is still useful.
|
|
362
|
+
*
|
|
363
|
+
* Three evidence problems are handled explicitly:
|
|
364
|
+
*
|
|
365
|
+
* - JSX text is not string syntax, so a prose apostrophe or quoted phrase is
|
|
366
|
+
* not masked (see `stringAllowed`);
|
|
367
|
+
* - a URL such as `https://example.test` is not a line comment (scheme guard);
|
|
368
|
+
* - template literal text is masked, but `${...}` expressions are scanned as
|
|
369
|
+
* code, so a hook call inside a placeholder is still reported.
|
|
370
|
+
*
|
|
371
|
+
* A residual limitation is a bare `//` in JSX prose (with no URL scheme): it
|
|
372
|
+
* is still read as a line comment.
|
|
373
|
+
*
|
|
374
|
+
* @param text - Decoded source text.
|
|
375
|
+
* @returns Masked text with the same length and line breaks.
|
|
376
|
+
*/
|
|
377
|
+
const maskReactSource = (text) => {
|
|
378
|
+
if (text.length === 0) {
|
|
379
|
+
return "";
|
|
380
|
+
}
|
|
381
|
+
const context = { text, length: text.length, characters: text.split("") };
|
|
382
|
+
scanCodeMask(context, 0, false);
|
|
383
|
+
return context.characters.join("");
|
|
384
|
+
};
|
|
385
|
+
/**
|
|
386
|
+
* Line starts, using `\n` as the only separator so a `\r` stays in its line.
|
|
387
|
+
*/
|
|
388
|
+
const lineStartsOf = (text) => {
|
|
389
|
+
if (text.length === 0) {
|
|
390
|
+
return [];
|
|
391
|
+
}
|
|
392
|
+
const starts = [0];
|
|
393
|
+
for (let index = 0; index < text.length; index += 1) {
|
|
394
|
+
if (text.charCodeAt(index) === 10 && index + 1 < text.length) {
|
|
395
|
+
starts.push(index + 1);
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
return starts;
|
|
399
|
+
};
|
|
400
|
+
/**
|
|
401
|
+
* 1-based line number containing one absolute offset.
|
|
402
|
+
*/
|
|
403
|
+
const lineAtOffset = (starts, offset) => {
|
|
404
|
+
if (starts.length === 0) {
|
|
405
|
+
return 1;
|
|
406
|
+
}
|
|
407
|
+
let low = 0;
|
|
408
|
+
let high = starts.length - 1;
|
|
409
|
+
while (low < high) {
|
|
410
|
+
const middle = Math.ceil((low + high) / 2);
|
|
411
|
+
if (starts[middle] <= offset) {
|
|
412
|
+
low = middle;
|
|
413
|
+
}
|
|
414
|
+
else {
|
|
415
|
+
high = middle - 1;
|
|
416
|
+
}
|
|
417
|
+
}
|
|
418
|
+
return low + 1;
|
|
419
|
+
};
|
|
420
|
+
/**
|
|
421
|
+
* Unicode BOM code unit. `decodeText` strips the byte-level BOM, but a caller
|
|
422
|
+
* that hands the parser an already-decoded string may still carry this
|
|
423
|
+
* character at offset zero.
|
|
424
|
+
*/
|
|
425
|
+
const BomCharacter = 0xfeff;
|
|
426
|
+
/**
|
|
427
|
+
* Read a source once and keep the masked view and line index consistent.
|
|
428
|
+
*
|
|
429
|
+
* A leading BOM character is removed from the parsed text and replaced by a
|
|
430
|
+
* fixed byte base, so the first `export` is still a declaration while the byte
|
|
431
|
+
* ranges stay anchored to the caller's raw text.
|
|
432
|
+
*
|
|
433
|
+
* @param text - Decoded source text, with or without a leading BOM character.
|
|
434
|
+
* @returns Source view used by the parser.
|
|
435
|
+
*/
|
|
436
|
+
const readReactSource = (text) => {
|
|
437
|
+
const hasBom = text.length > 0 && text.charCodeAt(0) === BomCharacter;
|
|
438
|
+
const body = hasBom ? text.slice(1) : text;
|
|
439
|
+
const starts = lineStartsOf(body);
|
|
440
|
+
return {
|
|
441
|
+
text: body,
|
|
442
|
+
masked: maskReactSource(body),
|
|
443
|
+
starts,
|
|
444
|
+
totalLines: starts.length,
|
|
445
|
+
byteIndex: new ByteLineIndex(body),
|
|
446
|
+
byteOffsetBase: hasBom ? 3n : 0n,
|
|
447
|
+
};
|
|
448
|
+
};
|
|
449
|
+
/**
|
|
450
|
+
* Character offset where a 1-based line starts.
|
|
451
|
+
*/
|
|
452
|
+
const lineStartOffset = (source, line) => source.starts[Math.max(0, line - 1)] ?? 0;
|
|
453
|
+
/**
|
|
454
|
+
* Character offset just past a 1-based line, including its newline.
|
|
455
|
+
*/
|
|
456
|
+
const lineEndOffset = (source, line) => {
|
|
457
|
+
if (line < source.totalLines) {
|
|
458
|
+
return source.starts[line] ?? source.masked.length;
|
|
459
|
+
}
|
|
460
|
+
return source.masked.length;
|
|
461
|
+
};
|
|
462
|
+
/**
|
|
463
|
+
* Escape one symbol segment so the `<file>#<symbol>` boundary stays parseable.
|
|
464
|
+
* Mirrors the registry escape so a directly parsed tree has the same paths as
|
|
465
|
+
* a registry-built one.
|
|
466
|
+
*/
|
|
467
|
+
const escapeSegment = (value) => value.replace(/%/g, "%25").replace(/#/g, "%23").replace(/\//g, "%2F");
|
|
468
|
+
/**
|
|
469
|
+
* Convert a React-local kind to the shared `OutlineType`.
|
|
470
|
+
*
|
|
471
|
+
* `OutlineKind` is owned by `types.ts`; widening it is a contract change for
|
|
472
|
+
* the main integration, so this module keeps the four React kinds local and
|
|
473
|
+
* performs the single controlled conversion here. No `any` is involved: the
|
|
474
|
+
* literals are real strings and the registry copies `type` through unchanged.
|
|
475
|
+
*/
|
|
476
|
+
const outlineTypeOf = (kind) => kind;
|
|
477
|
+
/**
|
|
478
|
+
* Build one outline node with a real UTF-8 byte range.
|
|
479
|
+
*
|
|
480
|
+
* The wrapped TypeScript tree carries `0n` placeholder bytes because the
|
|
481
|
+
* registry fills authoritative ranges from line numbers. Rebuilding every node
|
|
482
|
+
* here means a direct `parseReact` call already returns a complete node, which
|
|
483
|
+
* is what the boundary tests assert.
|
|
484
|
+
*/
|
|
485
|
+
const reactNode = (spec, source) => {
|
|
486
|
+
const decodedRange = source.byteIndex.range(spec.startLine, spec.endLine);
|
|
487
|
+
const range = source.byteOffsetBase === 0n
|
|
488
|
+
? decodedRange
|
|
489
|
+
: {
|
|
490
|
+
startByte: decodedRange.startByte + source.byteOffsetBase,
|
|
491
|
+
endByte: decodedRange.endByte + source.byteOffsetBase,
|
|
492
|
+
startLine: decodedRange.startLine,
|
|
493
|
+
endLine: decodedRange.endLine,
|
|
494
|
+
};
|
|
495
|
+
return {
|
|
496
|
+
isFile: false,
|
|
497
|
+
isDirectory: false,
|
|
498
|
+
path: spec.path,
|
|
499
|
+
type: outlineTypeOf(spec.kind),
|
|
500
|
+
range,
|
|
501
|
+
label: spec.label,
|
|
502
|
+
depth: Math.max(0, Math.trunc(spec.depth)),
|
|
503
|
+
...(spec.modifiers === (void 0) || spec.modifiers.length === 0 ? {} : { modifiers: [...spec.modifiers] }),
|
|
504
|
+
...(spec.detail === (void 0) || spec.detail.length === 0 ? {} : { detail: spec.detail }),
|
|
505
|
+
children: spec.children ?? [],
|
|
506
|
+
};
|
|
507
|
+
};
|
|
508
|
+
/**
|
|
509
|
+
* Collapse whitespace and cut one evidence snippet.
|
|
510
|
+
*/
|
|
511
|
+
const cleanSnippet = (value) => value.replace(/\s+/g, " ").trim().slice(0, 120);
|
|
512
|
+
/**
|
|
513
|
+
* JSX evidence: a `<` that opens a tag (or a fragment) in expression position.
|
|
514
|
+
*
|
|
515
|
+
* The prefix guard keeps a generic parameter list (`function Parse<T>(value: T)`)
|
|
516
|
+
* and a type argument (`Array<Props>`) out of the evidence: a tag must follow
|
|
517
|
+
* `return`, `=`, `(`, `,`, `:`, `?`, `&`, `|`, `>`, `;` or the range start, or
|
|
518
|
+
* begin a fragment. A single-letter tag (`<T>`) is treated as a generic.
|
|
519
|
+
*/
|
|
520
|
+
const JsxEvidence = /(?:^|[=({,\[:?&|>;]|\breturn\b|\bcase\b|\byield\b)\s*\(?\s*<(?:[\p{ID_Start}_$][\p{ID_Continue}$.:-]+|[A-Z](?:\s[^>]*)?>|[A-Z]\s*\/>|#[^>]*>|\/|>)/u;
|
|
521
|
+
/**
|
|
522
|
+
* Upper-case JSX tag with a simple name. Member tags (`<List.Item>`) are
|
|
523
|
+
* intentionally not collected: the dot would collide with the registry's
|
|
524
|
+
* nesting separator. A single-letter tag is collected only when it is
|
|
525
|
+
* self-closing or has a matching closing tag, which keeps a generic parameter
|
|
526
|
+
* (`<T>`) out of the tree.
|
|
527
|
+
*/
|
|
528
|
+
const JsxTag = /<\s*(\p{Lu}[\p{ID_Continue}$]*)(?=[\s/>])/gu;
|
|
529
|
+
/**
|
|
530
|
+
* Hook call: a `use[A-Z]...` identifier followed by optional type arguments and
|
|
531
|
+
* `(`. The one-level nested type-argument group covers `useRef<Record<string, number>>`
|
|
532
|
+
* without pretending to parse arbitrary type syntax.
|
|
533
|
+
*/
|
|
534
|
+
const HookCall = new RegExp("\\b(use\\p{Lu}[\\p{ID_Continue}$]*)\\s*(?:<[^<>()]*(?:<[^<>()]*>[^<>()]*)*>\\s*)?\\(", "gu");
|
|
535
|
+
/**
|
|
536
|
+
* Index of the `)` matching the `(` at `openIndex`, or `-1`.
|
|
537
|
+
*/
|
|
538
|
+
const matchingParen = (masked, openIndex) => {
|
|
539
|
+
let depth = 0;
|
|
540
|
+
for (let index = openIndex; index < masked.length; index += 1) {
|
|
541
|
+
const character = masked[index];
|
|
542
|
+
if (character === "(") {
|
|
543
|
+
depth += 1;
|
|
544
|
+
continue;
|
|
545
|
+
}
|
|
546
|
+
if (character === ")") {
|
|
547
|
+
depth -= 1;
|
|
548
|
+
if (depth === 0) {
|
|
549
|
+
return index;
|
|
550
|
+
}
|
|
551
|
+
}
|
|
552
|
+
}
|
|
553
|
+
return -1;
|
|
554
|
+
};
|
|
555
|
+
/**
|
|
556
|
+
* Whether a hook identifier is a declaration (`function useX(`) rather than a
|
|
557
|
+
* call. The wrapped TypeScript tree already reports the declaration node, so
|
|
558
|
+
* the call scan only has to skip it.
|
|
559
|
+
*/
|
|
560
|
+
const declarationBefore = /(?:\bfunction|\bclass|\binterface|\btype|\bconst|\blet|\bvar)\s+$/;
|
|
561
|
+
/**
|
|
562
|
+
* Find hook call sites in the masked source.
|
|
563
|
+
*
|
|
564
|
+
* A hook is reported once per name (first call wins), because an outline is a
|
|
565
|
+
* symbol index rather than a call graph. `React.useState` is accepted as a
|
|
566
|
+
* member call; any other receiver (`store.useThing`) is ignored. A method
|
|
567
|
+
* definition (`useThing() {`) is not a call and is skipped.
|
|
568
|
+
*
|
|
569
|
+
* @param source - Decoded and masked source.
|
|
570
|
+
* @returns First call site per hook name, in source order.
|
|
571
|
+
*/
|
|
572
|
+
const scanHookSites = (source) => {
|
|
573
|
+
const sites = [];
|
|
574
|
+
const seen = new Set();
|
|
575
|
+
HookCall.lastIndex = 0;
|
|
576
|
+
let match = HookCall.exec(source.masked);
|
|
577
|
+
while (match !== null) {
|
|
578
|
+
const name = match[1];
|
|
579
|
+
const openIndex = match.index + match[0].length - 1;
|
|
580
|
+
const before = source.masked.slice(Math.max(0, match.index - 48), match.index);
|
|
581
|
+
const memberCall = match.index > 0 &&
|
|
582
|
+
source.masked[match.index - 1] === "." &&
|
|
583
|
+
!/\bReact\s*$/.test(source.masked.slice(Math.max(0, match.index - 16), match.index - 1));
|
|
584
|
+
const closeIndex = matchingParen(source.masked, openIndex);
|
|
585
|
+
const startLine = lineAtOffset(source.starts, match.index);
|
|
586
|
+
const lineStart = lineStartOffset(source, startLine);
|
|
587
|
+
const atLineStart = source.masked.slice(lineStart, match.index).trim().length === 0;
|
|
588
|
+
const methodDefinition = closeIndex !== -1 &&
|
|
589
|
+
atLineStart &&
|
|
590
|
+
/^\s*(?::[^{;]*)?\{/.test(source.masked.slice(closeIndex + 1, closeIndex + 48));
|
|
591
|
+
if (!declarationBefore.test(before) && !memberCall && !methodDefinition && !seen.has(name)) {
|
|
592
|
+
seen.add(name);
|
|
593
|
+
const endLine = closeIndex === -1 ? startLine : lineAtOffset(source.starts, closeIndex);
|
|
594
|
+
const raw = closeIndex === -1
|
|
595
|
+
? source.text.slice(match.index, Math.min(source.text.length, match.index + 80))
|
|
596
|
+
: source.text.slice(match.index, closeIndex + 1);
|
|
597
|
+
sites.push({ name, startLine, endLine: Math.max(startLine, endLine), detail: cleanSnippet(raw) });
|
|
598
|
+
}
|
|
599
|
+
HookCall.lastIndex = match.index + match[0].length;
|
|
600
|
+
match = HookCall.exec(source.masked);
|
|
601
|
+
}
|
|
602
|
+
return sites;
|
|
603
|
+
};
|
|
604
|
+
/**
|
|
605
|
+
* Whether every tracked bracket is balanced.
|
|
606
|
+
*/
|
|
607
|
+
const isBalanced = (state) => state.braces === 0 && state.parens === 0 && state.brackets === 0;
|
|
608
|
+
/**
|
|
609
|
+
* Apply one masked character to a bracket state.
|
|
610
|
+
*/
|
|
611
|
+
const trackDelimiter = (masked, index, state) => {
|
|
612
|
+
const character = masked[index];
|
|
613
|
+
if (character === "{") {
|
|
614
|
+
state.braces += 1;
|
|
615
|
+
return;
|
|
616
|
+
}
|
|
617
|
+
if (character === "}") {
|
|
618
|
+
state.braces = Math.max(0, state.braces - 1);
|
|
619
|
+
return;
|
|
620
|
+
}
|
|
621
|
+
if (character === "(") {
|
|
622
|
+
state.parens += 1;
|
|
623
|
+
return;
|
|
624
|
+
}
|
|
625
|
+
if (character === ")") {
|
|
626
|
+
state.parens = Math.max(0, state.parens - 1);
|
|
627
|
+
return;
|
|
628
|
+
}
|
|
629
|
+
if (character === "[") {
|
|
630
|
+
state.brackets += 1;
|
|
631
|
+
return;
|
|
632
|
+
}
|
|
633
|
+
if (character === "]") {
|
|
634
|
+
state.brackets = Math.max(0, state.brackets - 1);
|
|
635
|
+
}
|
|
636
|
+
};
|
|
637
|
+
/**
|
|
638
|
+
* Reconcile a line reported by the wrapped scanner with the actual bracket
|
|
639
|
+
* balance of the masked source.
|
|
640
|
+
*
|
|
641
|
+
* `parseTypeScript` resolves a declaration end at the *first* `{` before a `;`,
|
|
642
|
+
* so a declaration whose header contains an inline object type
|
|
643
|
+
* (`React.memo(function Card(props: { title: string }) {` or
|
|
644
|
+
* `React.FC<{ title: string }>`) is reported as a one-line range and its body
|
|
645
|
+
* is invisible to the component evidence probe. When the reported end line
|
|
646
|
+
* leaves a bracket open, the range is extended to the first line where the
|
|
647
|
+
* declaration is balanced again. The forward scan is bounded (16 000 chars) so a
|
|
648
|
+
* malformed file cannot make one node cost the rest of the file.
|
|
649
|
+
*
|
|
650
|
+
* @param source - Decoded and masked source.
|
|
651
|
+
* @param startLine - 1-based declaration start.
|
|
652
|
+
* @param reportedEndLine - End line from the wrapped TypeScript tree.
|
|
653
|
+
* @returns Reported end line, or the reconciled one.
|
|
654
|
+
*/
|
|
655
|
+
const reconciledEndLine = (source, startLine, reportedEndLine) => {
|
|
656
|
+
const start = lineStartOffset(source, startLine);
|
|
657
|
+
const endLine = Math.max(startLine, Math.min(reportedEndLine, source.totalLines));
|
|
658
|
+
const reportedEnd = lineEndOffset(source, endLine);
|
|
659
|
+
const state = { braces: 0, parens: 0, brackets: 0 };
|
|
660
|
+
let index = start;
|
|
661
|
+
while (index < reportedEnd) {
|
|
662
|
+
trackDelimiter(source.masked, index, state);
|
|
663
|
+
index += 1;
|
|
664
|
+
}
|
|
665
|
+
if (isBalanced(state)) {
|
|
666
|
+
return endLine;
|
|
667
|
+
}
|
|
668
|
+
const limit = Math.min(source.masked.length, start + 16000);
|
|
669
|
+
while (index < limit) {
|
|
670
|
+
trackDelimiter(source.masked, index, state);
|
|
671
|
+
if (isBalanced(state)) {
|
|
672
|
+
return lineAtOffset(source.starts, index);
|
|
673
|
+
}
|
|
674
|
+
index += 1;
|
|
675
|
+
}
|
|
676
|
+
return endLine;
|
|
677
|
+
};
|
|
678
|
+
/**
|
|
679
|
+
* Effective inclusive end line of a wrapped node.
|
|
680
|
+
*/
|
|
681
|
+
const effectiveEndLine = (source, node) => {
|
|
682
|
+
const startLine = Number(node.range.startLine);
|
|
683
|
+
return reconciledEndLine(source, startLine, Math.max(startLine, Number(node.range.endLine)));
|
|
684
|
+
};
|
|
685
|
+
/**
|
|
686
|
+
* Start line of a wrapped node.
|
|
687
|
+
*/
|
|
688
|
+
const startLineOf = (node) => Math.max(1, Number(node.range.startLine));
|
|
689
|
+
/**
|
|
690
|
+
* Whether a line span contains JSX in expression position.
|
|
691
|
+
*/
|
|
692
|
+
const hasJsxBetween = (source, startLine, endLine) => {
|
|
693
|
+
const from = lineStartOffset(source, startLine);
|
|
694
|
+
const to = lineEndOffset(source, Math.max(startLine, endLine));
|
|
695
|
+
return JsxEvidence.test(source.masked.slice(from, to));
|
|
696
|
+
};
|
|
697
|
+
/**
|
|
698
|
+
* Whether a wrapped declaration's effective range contains JSX.
|
|
699
|
+
*/
|
|
700
|
+
const hasJsxInNode = (source, node) => hasJsxBetween(source, startLineOf(node), effectiveEndLine(source, node));
|
|
701
|
+
/**
|
|
702
|
+
* Upper-case component identifier. `\p{Lu}` keeps the check correct for a
|
|
703
|
+
* Unicode identifier (`Café`, `ΔApp`); the wrapped declaration scanner may
|
|
704
|
+
* report such a name, and the outline label keeps it verbatim.
|
|
705
|
+
*/
|
|
706
|
+
const ComponentName = /^\p{Lu}[\p{ID_Continue}$]*$/u;
|
|
707
|
+
/**
|
|
708
|
+
* Custom hook identifier (`useCounter`, `useÉchelle`).
|
|
709
|
+
*/
|
|
710
|
+
const CustomHookName = /^use\p{Lu}[\p{ID_Continue}$]*$/u;
|
|
711
|
+
/**
|
|
712
|
+
* A props declaration name: `Props`, `ButtonProps`, `GreetingProps`.
|
|
713
|
+
*/
|
|
714
|
+
const PropsName = /Props$/;
|
|
715
|
+
/**
|
|
716
|
+
* Class component base class.
|
|
717
|
+
*/
|
|
718
|
+
const ClassComponent = /\bextends\s+(?:React\s*\.\s*)?(?:PureComponent|Component)\b/;
|
|
719
|
+
/**
|
|
720
|
+
* `React.FC` / `React.FunctionComponent` / `React.ComponentType` annotation.
|
|
721
|
+
*/
|
|
722
|
+
const FunctionComponentType = /:\s*(?:React\s*\.\s*)?(?:FC|FunctionComponent|ComponentType)\s*[<=(]/;
|
|
723
|
+
/**
|
|
724
|
+
* `React.memo(...)` or `React.forwardRef(...)` wrapper (or the bare imported
|
|
725
|
+
* form). The leading `[^\w$]` keeps `useMemo(` from matching `memo`.
|
|
726
|
+
*/
|
|
727
|
+
const WrapperComponent = /(?:^|[^\w$])(?:React\s*\.\s*)?(?:memo|forwardRef)\s*(?:<[^<>()]*>\s*)?\(/;
|
|
728
|
+
/**
|
|
729
|
+
* `export default` header.
|
|
730
|
+
*/
|
|
731
|
+
const DefaultExport = /^export\s+default\b/;
|
|
732
|
+
/**
|
|
733
|
+
* Anonymous default arrow header (`export default () =>`, `export default (props: Props) =>`).
|
|
734
|
+
*/
|
|
735
|
+
const DefaultArrow = /^export\s+default\s+(?:async\s+)?(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*(?::[^=;\n]*)?=>/;
|
|
736
|
+
/**
|
|
737
|
+
* Classify one wrapped declaration.
|
|
738
|
+
*
|
|
739
|
+
* Order matters: a `useX` function is a hook even when it returns JSX, and a
|
|
740
|
+
* props interface is props before any component check runs.
|
|
741
|
+
*
|
|
742
|
+
* @param node - Node returned by `parseTypeScript`.
|
|
743
|
+
* @param source - Decoded source for JSX evidence.
|
|
744
|
+
* @returns React role.
|
|
745
|
+
*/
|
|
746
|
+
const classifyReactNode = (node, source) => {
|
|
747
|
+
const detail = node.detail ?? "";
|
|
748
|
+
const type = node.type;
|
|
749
|
+
if ((type === "interface" || type === "type") && PropsName.test(node.label)) {
|
|
750
|
+
return "props";
|
|
751
|
+
}
|
|
752
|
+
if (type === "class" && ClassComponent.test(detail)) {
|
|
753
|
+
return "component";
|
|
754
|
+
}
|
|
755
|
+
if (type === "function" && CustomHookName.test(node.label)) {
|
|
756
|
+
return "hook";
|
|
757
|
+
}
|
|
758
|
+
const functionLike = type === "function" || type === "constant" || type === "variable";
|
|
759
|
+
if (functionLike && ComponentName.test(node.label)) {
|
|
760
|
+
if (FunctionComponentType.test(detail)) {
|
|
761
|
+
return "component";
|
|
762
|
+
}
|
|
763
|
+
const wrapped = WrapperComponent.test(detail);
|
|
764
|
+
if ((wrapped || type === "function") && hasJsxInNode(source, node)) {
|
|
765
|
+
return "component";
|
|
766
|
+
}
|
|
767
|
+
}
|
|
768
|
+
if (node.label === "default" && DefaultExport.test(detail) && /(?:function\b|=>)/.test(detail) && hasJsxInNode(source, node)) {
|
|
769
|
+
return "component";
|
|
770
|
+
}
|
|
771
|
+
return "outline";
|
|
772
|
+
};
|
|
773
|
+
/**
|
|
774
|
+
* Collect upper-case JSX tags used inside one component range.
|
|
775
|
+
*
|
|
776
|
+
* A tag that directly follows an identifier, `)`, `]` or `.` is a type
|
|
777
|
+
* argument (`React.Component<Props>`, `Array<Item>`) and is skipped. A
|
|
778
|
+
* single-letter tag is kept only when it is self-closing (`<A />`) or has a
|
|
779
|
+
* matching closing tag, so a generic parameter (`<T>`) is not a child. The
|
|
780
|
+
* first and last usage lines become the child's range; duplicates collapse
|
|
781
|
+
* into one `jsx` child per name.
|
|
782
|
+
*
|
|
783
|
+
* @param source - Decoded source.
|
|
784
|
+
* @param parentPath - Path of the owning component.
|
|
785
|
+
* @param depth - Depth of the new children.
|
|
786
|
+
* @param startLine - Inclusive component start.
|
|
787
|
+
* @param endLine - Inclusive component end.
|
|
788
|
+
* @returns Deduplicated `jsx` children sorted by first usage.
|
|
789
|
+
*/
|
|
790
|
+
const collectJsxChildren = (source, parentPath, depth, startLine, endLine) => {
|
|
791
|
+
const from = lineStartOffset(source, startLine);
|
|
792
|
+
const to = lineEndOffset(source, Math.max(startLine, endLine));
|
|
793
|
+
const text = source.masked.slice(from, to);
|
|
794
|
+
const found = new Map();
|
|
795
|
+
JsxTag.lastIndex = 0;
|
|
796
|
+
let match = JsxTag.exec(text);
|
|
797
|
+
while (match !== null) {
|
|
798
|
+
const name = match[1];
|
|
799
|
+
const previous = match.index > 0 ? text[match.index - 1] : "";
|
|
800
|
+
const following = text.slice(match.index + match[0].length, match.index + match[0].length + 16);
|
|
801
|
+
const generic = /[A-Za-z0-9_$)\].]/.test(previous);
|
|
802
|
+
const singleLetter = name.length === 1;
|
|
803
|
+
const selfClosing = /^\s*\/\s*>/.test(following);
|
|
804
|
+
const paired = singleLetter && new RegExp("</\\s*" + name + "\\s*>", "u").test(text);
|
|
805
|
+
const usable = !generic && (!singleLetter || selfClosing || paired);
|
|
806
|
+
if (usable) {
|
|
807
|
+
const line = lineAtOffset(source.starts, from + match.index);
|
|
808
|
+
const entry = found.get(name);
|
|
809
|
+
if (entry === (void 0)) {
|
|
810
|
+
found.set(name, { first: line, last: line });
|
|
811
|
+
}
|
|
812
|
+
else if (line > entry.last) {
|
|
813
|
+
entry.last = line;
|
|
814
|
+
}
|
|
815
|
+
}
|
|
816
|
+
JsxTag.lastIndex = match.index + match[0].length;
|
|
817
|
+
match = JsxTag.exec(text);
|
|
818
|
+
}
|
|
819
|
+
const children = [];
|
|
820
|
+
found.forEach((lines, name) => {
|
|
821
|
+
children.push(reactNode({
|
|
822
|
+
label: name,
|
|
823
|
+
kind: "jsx",
|
|
824
|
+
startLine: lines.first,
|
|
825
|
+
endLine: Math.max(lines.first, lines.last),
|
|
826
|
+
depth,
|
|
827
|
+
path: `${parentPath}.${escapeSegment(name)}`,
|
|
828
|
+
}, source));
|
|
829
|
+
});
|
|
830
|
+
children.sort((left, right) => Number(left.range.startLine) - Number(right.range.startLine));
|
|
831
|
+
return children;
|
|
832
|
+
};
|
|
833
|
+
/**
|
|
834
|
+
* Path segment for one node under a parent path.
|
|
835
|
+
*/
|
|
836
|
+
const nodePath = (parentPath, label, filePath) => parentPath.length === 0 ? `${filePath}#${escapeSegment(label)}` : `${parentPath}.${escapeSegment(label)}`;
|
|
837
|
+
/**
|
|
838
|
+
* Rebuild a wrapped child list, keeping the TypeScript member semantics.
|
|
839
|
+
*/
|
|
840
|
+
const rebuildChildren = (nodes, parentPath, depth, context) => {
|
|
841
|
+
const rebuilt = [];
|
|
842
|
+
for (let index = 0; index < nodes.length; index += 1) {
|
|
843
|
+
rebuilt.push(rebuildNode(nodes[index], parentPath, depth, context, "outline"));
|
|
844
|
+
}
|
|
845
|
+
return rebuilt;
|
|
846
|
+
};
|
|
847
|
+
/**
|
|
848
|
+
* Rebuild one wrapped node with a React role, a real byte range and a path.
|
|
849
|
+
*
|
|
850
|
+
* @param node - Node returned by `parseTypeScript`.
|
|
851
|
+
* @param parentPath - Empty for a top-level symbol, the parent path otherwise.
|
|
852
|
+
* @param depth - Zero-based depth below the file anchor.
|
|
853
|
+
* @param context - File path and decoded source.
|
|
854
|
+
* @param role - React role decided by `classifyReactNode`.
|
|
855
|
+
* @returns New node.
|
|
856
|
+
*/
|
|
857
|
+
const rebuildNode = (node, parentPath, depth, context, role) => {
|
|
858
|
+
const label = node.label;
|
|
859
|
+
const path = nodePath(parentPath, label, context.filePath);
|
|
860
|
+
const startLine = startLineOf(node);
|
|
861
|
+
const endLine = Math.max(startLine, effectiveEndLine(context.source, node));
|
|
862
|
+
const children = rebuildChildren(node.children, path, depth + 1, context);
|
|
863
|
+
let kind;
|
|
864
|
+
if (role === "component") {
|
|
865
|
+
kind = "component";
|
|
866
|
+
}
|
|
867
|
+
else if (role === "hook") {
|
|
868
|
+
kind = "hook";
|
|
869
|
+
}
|
|
870
|
+
else if (role === "props") {
|
|
871
|
+
kind = "props";
|
|
872
|
+
}
|
|
873
|
+
else {
|
|
874
|
+
kind = node.type;
|
|
875
|
+
}
|
|
876
|
+
if (role === "component") {
|
|
877
|
+
const jsxChildren = collectJsxChildren(context.source, path, depth + 1, startLine, endLine);
|
|
878
|
+
for (let index = 0; index < jsxChildren.length; index += 1) {
|
|
879
|
+
children.push(jsxChildren[index]);
|
|
880
|
+
}
|
|
881
|
+
children.sort((left, right) => Number(left.range.startLine) - Number(right.range.startLine));
|
|
882
|
+
}
|
|
883
|
+
return reactNode({
|
|
884
|
+
label,
|
|
885
|
+
kind,
|
|
886
|
+
startLine,
|
|
887
|
+
endLine,
|
|
888
|
+
depth,
|
|
889
|
+
path,
|
|
890
|
+
...(node.detail === (void 0) ? {} : { detail: node.detail }),
|
|
891
|
+
...(node.modifiers === (void 0) ? {} : { modifiers: node.modifiers }),
|
|
892
|
+
children,
|
|
893
|
+
}, context.source);
|
|
894
|
+
};
|
|
895
|
+
/**
|
|
896
|
+
* End line of a whole statement, used only for the anonymous-default fallback.
|
|
897
|
+
*
|
|
898
|
+
* @param source - Decoded source.
|
|
899
|
+
* @param startLine - 1-based statement start.
|
|
900
|
+
* @returns Inclusive end line, bounded to 40 lines past the start.
|
|
901
|
+
*/
|
|
902
|
+
const statementEndLine = (source, startLine) => {
|
|
903
|
+
const start = lineStartOffset(source, startLine);
|
|
904
|
+
const limit = Math.min(source.masked.length, start + 8000);
|
|
905
|
+
let depth = 0;
|
|
906
|
+
for (let index = start; index < limit; index += 1) {
|
|
907
|
+
const character = source.masked[index];
|
|
908
|
+
if (character === "(" || character === "[" || character === "{") {
|
|
909
|
+
depth += 1;
|
|
910
|
+
continue;
|
|
911
|
+
}
|
|
912
|
+
if (character === ")" || character === "]") {
|
|
913
|
+
depth = Math.max(0, depth - 1);
|
|
914
|
+
continue;
|
|
915
|
+
}
|
|
916
|
+
if (character === "}") {
|
|
917
|
+
depth = Math.max(0, depth - 1);
|
|
918
|
+
if (depth === 0) {
|
|
919
|
+
let rest = false;
|
|
920
|
+
for (let peek = index + 1; peek < source.masked.length; peek += 1) {
|
|
921
|
+
const next = source.masked[peek];
|
|
922
|
+
if (next === "\n") {
|
|
923
|
+
break;
|
|
924
|
+
}
|
|
925
|
+
if (!/\s/.test(next)) {
|
|
926
|
+
rest = true;
|
|
927
|
+
break;
|
|
928
|
+
}
|
|
929
|
+
}
|
|
930
|
+
if (!rest) {
|
|
931
|
+
return lineAtOffset(source.starts, index);
|
|
932
|
+
}
|
|
933
|
+
}
|
|
934
|
+
continue;
|
|
935
|
+
}
|
|
936
|
+
if (character === ";" && depth === 0) {
|
|
937
|
+
return lineAtOffset(source.starts, index);
|
|
938
|
+
}
|
|
939
|
+
}
|
|
940
|
+
return Math.min(source.totalLines, startLine + 40);
|
|
941
|
+
};
|
|
942
|
+
/**
|
|
943
|
+
* Find an `export default () => ...` header that the TypeScript scanner does
|
|
944
|
+
* not turn into a declaration (an anonymous default arrow).
|
|
945
|
+
*
|
|
946
|
+
* @param source - Decoded source.
|
|
947
|
+
* @param existing - Already-built top-level nodes, used to avoid a duplicate.
|
|
948
|
+
* @returns Line span, or `undefined`.
|
|
949
|
+
*/
|
|
950
|
+
const findAnonymousDefaultComponent = (source, existing) => {
|
|
951
|
+
for (let line = 1; line <= source.totalLines; line += 1) {
|
|
952
|
+
const from = lineStartOffset(source, line);
|
|
953
|
+
const to = lineEndOffset(source, line);
|
|
954
|
+
if (!/^export\s+default\b/.test(source.masked.slice(from, to).trim())) {
|
|
955
|
+
continue;
|
|
956
|
+
}
|
|
957
|
+
const window = source.masked.slice(from, Math.min(source.masked.length, from + 800));
|
|
958
|
+
if (!DefaultArrow.test(window)) {
|
|
959
|
+
continue;
|
|
960
|
+
}
|
|
961
|
+
const duplicate = existing.some((node) => startLineOf(node) === line);
|
|
962
|
+
if (duplicate) {
|
|
963
|
+
continue;
|
|
964
|
+
}
|
|
965
|
+
const endLine = Math.max(line, statementEndLine(source, line));
|
|
966
|
+
if (!hasJsxBetween(source, line, endLine)) {
|
|
967
|
+
continue;
|
|
968
|
+
}
|
|
969
|
+
return { startLine: line, endLine };
|
|
970
|
+
}
|
|
971
|
+
return undefined;
|
|
972
|
+
};
|
|
973
|
+
/**
|
|
974
|
+
* Stable sort of top-level nodes by start line.
|
|
975
|
+
*/
|
|
976
|
+
const sortByStartLine = (nodes) => [...nodes].sort((left, right) => Number(left.range.startLine) - Number(right.range.startLine));
|
|
977
|
+
/**
|
|
978
|
+
* Parse a React/JSX module.
|
|
979
|
+
*
|
|
980
|
+
* The declaration tree comes from `parseTypeScript`; this function adds the
|
|
981
|
+
* React semantics described in the module header, gives every node a
|
|
982
|
+
* `<file>#<symbol>` path, a UTF-8 byte range and a depth, and emits one hook
|
|
983
|
+
* node per name. The result is ordered by start line at the top level. It is a
|
|
984
|
+
* pure function of `input.text`.
|
|
985
|
+
*
|
|
986
|
+
* @param input - Decoded source text and its path.
|
|
987
|
+
* @returns React symbol tree; empty for an empty file.
|
|
988
|
+
*/
|
|
989
|
+
export const parseReact = (input) => {
|
|
990
|
+
const source = readReactSource(input.text);
|
|
991
|
+
if (source.totalLines === 0) {
|
|
992
|
+
return [];
|
|
993
|
+
}
|
|
994
|
+
/**
|
|
995
|
+
* The wrapped scanner must see the same BOM-free text the React source view
|
|
996
|
+
* uses; `lineIndex` is rebuilt for that text because the original index may
|
|
997
|
+
* still include the removed BOM character.
|
|
998
|
+
*/
|
|
999
|
+
const parseInput = { path: input.path, text: source.text, lineIndex: new LineIndex(source.text) };
|
|
1000
|
+
const declarations = parseTypeScript(parseInput);
|
|
1001
|
+
const context = { filePath: input.path, source };
|
|
1002
|
+
const nodes = [];
|
|
1003
|
+
const declaredHooks = new Set();
|
|
1004
|
+
for (let index = 0; index < declarations.length; index += 1) {
|
|
1005
|
+
const declaration = declarations[index];
|
|
1006
|
+
const role = classifyReactNode(declaration, source);
|
|
1007
|
+
if (role === "hook") {
|
|
1008
|
+
declaredHooks.add(declaration.label);
|
|
1009
|
+
}
|
|
1010
|
+
nodes.push(rebuildNode(declaration, "", 0, context, role));
|
|
1011
|
+
}
|
|
1012
|
+
const sites = scanHookSites(source);
|
|
1013
|
+
for (let index = 0; index < sites.length; index += 1) {
|
|
1014
|
+
const site = sites[index];
|
|
1015
|
+
if (declaredHooks.has(site.name)) {
|
|
1016
|
+
continue;
|
|
1017
|
+
}
|
|
1018
|
+
nodes.push(reactNode({
|
|
1019
|
+
label: site.name,
|
|
1020
|
+
kind: "hook",
|
|
1021
|
+
startLine: site.startLine,
|
|
1022
|
+
endLine: site.endLine,
|
|
1023
|
+
depth: 0,
|
|
1024
|
+
path: nodePath("", site.name, input.path),
|
|
1025
|
+
detail: site.detail,
|
|
1026
|
+
}, source));
|
|
1027
|
+
}
|
|
1028
|
+
const anonymousDefault = findAnonymousDefaultComponent(source, nodes);
|
|
1029
|
+
if (anonymousDefault !== undefined) {
|
|
1030
|
+
const path = nodePath("", "default", input.path);
|
|
1031
|
+
nodes.push(reactNode({
|
|
1032
|
+
label: "default",
|
|
1033
|
+
kind: "component",
|
|
1034
|
+
startLine: anonymousDefault.startLine,
|
|
1035
|
+
endLine: anonymousDefault.endLine,
|
|
1036
|
+
depth: 0,
|
|
1037
|
+
path,
|
|
1038
|
+
detail: "export default",
|
|
1039
|
+
children: collectJsxChildren(source, path, 1, anonymousDefault.startLine, anonymousDefault.endLine),
|
|
1040
|
+
}, source));
|
|
1041
|
+
}
|
|
1042
|
+
return sortByStartLine(nodes);
|
|
1043
|
+
};
|
|
1044
|
+
/**
|
|
1045
|
+
* Whether a base name has a React extension.
|
|
1046
|
+
*/
|
|
1047
|
+
const hasReactExtension = (name) => {
|
|
1048
|
+
const dot = name.lastIndexOf(".");
|
|
1049
|
+
if (dot <= 0 || dot === name.length - 1) {
|
|
1050
|
+
return false;
|
|
1051
|
+
}
|
|
1052
|
+
return ReactExtensions.includes(name.slice(dot).toLowerCase());
|
|
1053
|
+
};
|
|
1054
|
+
/**
|
|
1055
|
+
* React/JSX outline strategy.
|
|
1056
|
+
*
|
|
1057
|
+
* `matches` requires one of `.tsx`/`.jsx` *and* React evidence in the head, so
|
|
1058
|
+
* a plain TSX file falls through to the TypeScript strategy. Because both the
|
|
1059
|
+
* TypeScript and JavaScript strategies also claim these extensions, this
|
|
1060
|
+
* strategy has to be registered ahead of them; `docs/testing/languages/reactReport.md`
|
|
1061
|
+
* records the integration order.
|
|
1062
|
+
*/
|
|
1063
|
+
export const ReactStrategy = {
|
|
1064
|
+
id: "react",
|
|
1065
|
+
category: "code",
|
|
1066
|
+
language: "react",
|
|
1067
|
+
matches: (input) => hasReactExtension(input.name) &&
|
|
1068
|
+
ReactEvidence.some((evidence) => evidence.test(input.head)),
|
|
1069
|
+
parse: parseReact,
|
|
1070
|
+
};
|