@hydranium/core 1.0.0-next.14 → 1.0.0-next.140
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/README.md +5 -1
- package/lib/documents/ast-document-manager.d.ts +187 -27
- package/lib/documents/ast-document-manager.d.ts.map +1 -1
- package/lib/documents/ast-document-manager.js +235 -38
- package/lib/documents/ast-document-manager.js.map +1 -1
- package/lib/documents/client-ids.d.ts +5 -19
- package/lib/documents/client-ids.d.ts.map +1 -1
- package/lib/documents/client-ids.js +5 -19
- package/lib/documents/client-ids.js.map +1 -1
- package/lib/documents/client-session-errors.d.ts +15 -0
- package/lib/documents/client-session-errors.d.ts.map +1 -0
- package/lib/documents/client-session-errors.js +15 -0
- package/lib/documents/client-session-errors.js.map +1 -0
- package/lib/documents/client-session-registry.d.ts +138 -0
- package/lib/documents/client-session-registry.d.ts.map +1 -0
- package/lib/documents/client-session-registry.js +187 -0
- package/lib/documents/client-session-registry.js.map +1 -0
- package/lib/documents/file-system-task-queue.d.ts +49 -0
- package/lib/documents/file-system-task-queue.d.ts.map +1 -0
- package/lib/documents/file-system-task-queue.js +34 -0
- package/lib/documents/file-system-task-queue.js.map +1 -0
- package/lib/documents/hydranium-text-documents.d.ts +386 -57
- package/lib/documents/hydranium-text-documents.d.ts.map +1 -1
- package/lib/documents/hydranium-text-documents.js +697 -113
- package/lib/documents/hydranium-text-documents.js.map +1 -1
- package/lib/documents/index.d.ts +3 -0
- package/lib/documents/index.d.ts.map +1 -1
- package/lib/documents/index.js +3 -0
- package/lib/documents/index.js.map +1 -1
- package/lib/documents/language-client-text-shadow.d.ts +41 -9
- package/lib/documents/language-client-text-shadow.d.ts.map +1 -1
- package/lib/documents/language-client-text-shadow.js +56 -11
- package/lib/documents/language-client-text-shadow.js.map +1 -1
- package/lib/documents/self-save-registry.d.ts +37 -6
- package/lib/documents/self-save-registry.d.ts.map +1 -1
- package/lib/documents/self-save-registry.js +28 -15
- package/lib/documents/self-save-registry.js.map +1 -1
- package/lib/index.d.ts +3 -0
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +6 -0
- package/lib/index.js.map +1 -1
- package/lib/langium/ast-extension/ast-node-builder.d.ts +32 -9
- package/lib/langium/ast-extension/ast-node-builder.d.ts.map +1 -1
- package/lib/langium/ast-extension/ast-node-builder.js +60 -22
- package/lib/langium/ast-extension/ast-node-builder.js.map +1 -1
- package/lib/langium/bootstrap.d.ts.map +1 -1
- package/lib/langium/bootstrap.js +16 -9
- package/lib/langium/bootstrap.js.map +1 -1
- package/lib/langium/config/configuration-provider.d.ts +81 -0
- package/lib/langium/config/configuration-provider.d.ts.map +1 -0
- package/lib/langium/config/configuration-provider.js +112 -0
- package/lib/langium/config/configuration-provider.js.map +1 -0
- package/lib/langium/config/index.d.ts +1 -0
- package/lib/langium/config/index.d.ts.map +1 -1
- package/lib/langium/config/index.js +1 -0
- package/lib/langium/config/index.js.map +1 -1
- package/lib/langium/diagnostics/lsp-logger.d.ts +17 -0
- package/lib/langium/diagnostics/lsp-logger.d.ts.map +1 -1
- package/lib/langium/diagnostics/lsp-logger.js +40 -6
- package/lib/langium/diagnostics/lsp-logger.js.map +1 -1
- package/lib/langium/document-builder/build-pipeline-integration.d.ts +21 -1
- package/lib/langium/document-builder/build-pipeline-integration.d.ts.map +1 -1
- package/lib/langium/document-builder/build-pipeline-integration.js +32 -5
- package/lib/langium/document-builder/build-pipeline-integration.js.map +1 -1
- package/lib/langium/document-builder/build-session.d.ts +93 -0
- package/lib/langium/document-builder/build-session.d.ts.map +1 -0
- package/lib/langium/document-builder/build-session.js +72 -0
- package/lib/langium/document-builder/build-session.js.map +1 -0
- package/lib/langium/document-builder/document-builder.d.ts +220 -11
- package/lib/langium/document-builder/document-builder.d.ts.map +1 -1
- package/lib/langium/document-builder/document-builder.js +409 -27
- package/lib/langium/document-builder/document-builder.js.map +1 -1
- package/lib/langium/document-builder/index.d.ts +1 -0
- package/lib/langium/document-builder/index.d.ts.map +1 -1
- package/lib/langium/document-builder/index.js +1 -0
- package/lib/langium/document-builder/index.js.map +1 -1
- package/lib/langium/integration-services.d.ts +45 -1
- package/lib/langium/integration-services.d.ts.map +1 -1
- package/lib/langium/integration-services.js +10 -5
- package/lib/langium/integration-services.js.map +1 -1
- package/lib/langium/integrity/integrity-rule.d.ts +13 -5
- package/lib/langium/integrity/integrity-rule.d.ts.map +1 -1
- package/lib/langium/integrity/integrity-rule.js.map +1 -1
- package/lib/langium/integrity/integrity-service.d.ts +50 -6
- package/lib/langium/integrity/integrity-service.d.ts.map +1 -1
- package/lib/langium/integrity/integrity-service.js +193 -17
- package/lib/langium/integrity/integrity-service.js.map +1 -1
- package/lib/langium/keys/containment.d.ts +64 -0
- package/lib/langium/keys/containment.d.ts.map +1 -0
- package/lib/langium/keys/containment.js +53 -0
- package/lib/langium/keys/containment.js.map +1 -0
- package/lib/langium/keys/index.d.ts +1 -0
- package/lib/langium/keys/index.d.ts.map +1 -1
- package/lib/langium/keys/index.js +1 -0
- package/lib/langium/keys/index.js.map +1 -1
- package/lib/langium/keys/name-based-key-provider.d.ts +4 -0
- package/lib/langium/keys/name-based-key-provider.d.ts.map +1 -1
- package/lib/langium/keys/name-based-key-provider.js +4 -0
- package/lib/langium/keys/name-based-key-provider.js.map +1 -1
- package/lib/langium/language-module.d.ts +27 -2
- package/lib/langium/language-module.d.ts.map +1 -1
- package/lib/langium/language-module.js +16 -2
- package/lib/langium/language-module.js.map +1 -1
- package/lib/langium/model-service/client-session.d.ts +307 -0
- package/lib/langium/model-service/client-session.d.ts.map +1 -0
- package/lib/langium/model-service/client-session.js +395 -0
- package/lib/langium/model-service/client-session.js.map +1 -0
- package/lib/langium/model-service/index.d.ts +1 -0
- package/lib/langium/model-service/index.d.ts.map +1 -1
- package/lib/langium/model-service/index.js +1 -0
- package/lib/langium/model-service/index.js.map +1 -1
- package/lib/langium/model-service/model-service.d.ts +240 -174
- package/lib/langium/model-service/model-service.d.ts.map +1 -1
- package/lib/langium/model-service/model-service.js +207 -314
- package/lib/langium/model-service/model-service.js.map +1 -1
- package/lib/langium/module.d.ts +102 -18
- package/lib/langium/module.d.ts.map +1 -1
- package/lib/langium/module.js +30 -12
- package/lib/langium/module.js.map +1 -1
- package/lib/langium/naming/name-provider.d.ts +25 -4
- package/lib/langium/naming/name-provider.d.ts.map +1 -1
- package/lib/langium/naming/name-provider.js +2 -1
- package/lib/langium/naming/name-provider.js.map +1 -1
- package/lib/langium/naming/name-separator-validation.d.ts +23 -0
- package/lib/langium/naming/name-separator-validation.d.ts.map +1 -1
- package/lib/langium/naming/name-separator-validation.js +30 -1
- package/lib/langium/naming/name-separator-validation.js.map +1 -1
- package/lib/langium/residency/cst-residency-service.d.ts +31 -11
- package/lib/langium/residency/cst-residency-service.d.ts.map +1 -1
- package/lib/langium/residency/cst-residency-service.js +13 -56
- package/lib/langium/residency/cst-residency-service.js.map +1 -1
- package/lib/langium/scope/hydranium-scope-provider.d.ts +48 -13
- package/lib/langium/scope/hydranium-scope-provider.d.ts.map +1 -1
- package/lib/langium/scope/hydranium-scope-provider.js +56 -20
- package/lib/langium/scope/hydranium-scope-provider.js.map +1 -1
- package/lib/langium/serialization/abstract-serializer.d.ts +11 -20
- package/lib/langium/serialization/abstract-serializer.d.ts.map +1 -1
- package/lib/langium/serialization/abstract-serializer.js +12 -21
- package/lib/langium/serialization/abstract-serializer.js.map +1 -1
- package/lib/langium/service-registry.d.ts +15 -1
- package/lib/langium/service-registry.d.ts.map +1 -1
- package/lib/langium/service-registry.js +16 -0
- package/lib/langium/service-registry.js.map +1 -1
- package/lib/langium/shared-services.d.ts +15 -2
- package/lib/langium/shared-services.d.ts.map +1 -1
- package/lib/langium/shared-services.js.map +1 -1
- package/lib/langium/transfer/transfer-encoder.d.ts +60 -17
- package/lib/langium/transfer/transfer-encoder.d.ts.map +1 -1
- package/lib/langium/transfer/transfer-encoder.js +38 -16
- package/lib/langium/transfer/transfer-encoder.js.map +1 -1
- package/lib/langium/trivia/comment-preserver.d.ts +423 -0
- package/lib/langium/trivia/comment-preserver.d.ts.map +1 -0
- package/lib/langium/trivia/comment-preserver.js +906 -0
- package/lib/langium/trivia/comment-preserver.js.map +1 -0
- package/lib/langium/trivia/document-ending-preserver.d.ts +43 -0
- package/lib/langium/trivia/document-ending-preserver.d.ts.map +1 -0
- package/lib/langium/trivia/document-ending-preserver.js +48 -0
- package/lib/langium/trivia/document-ending-preserver.js.map +1 -0
- package/lib/langium/trivia/index.d.ts +14 -0
- package/lib/langium/trivia/index.d.ts.map +1 -0
- package/lib/langium/trivia/index.js +14 -0
- package/lib/langium/trivia/index.js.map +1 -0
- package/lib/langium/trivia/trivia-contribution.d.ts +37 -0
- package/lib/langium/trivia/trivia-contribution.d.ts.map +1 -0
- package/lib/langium/trivia/trivia-contribution.js +10 -0
- package/lib/langium/trivia/trivia-contribution.js.map +1 -0
- package/lib/langium/trivia/trivia-preserver.d.ts +50 -0
- package/lib/langium/trivia/trivia-preserver.d.ts.map +1 -0
- package/lib/langium/trivia/trivia-preserver.js +10 -0
- package/lib/langium/trivia/trivia-preserver.js.map +1 -0
- package/lib/langium/trivia/trivia-service.d.ts +70 -0
- package/lib/langium/trivia/trivia-service.d.ts.map +1 -0
- package/lib/langium/trivia/trivia-service.js +56 -0
- package/lib/langium/trivia/trivia-service.js.map +1 -0
- package/lib/langium/update-rewrite/update-rewrite.d.ts +1 -1
- package/lib/langium/validation/document-validator.d.ts +294 -10
- package/lib/langium/validation/document-validator.d.ts.map +1 -1
- package/lib/langium/validation/document-validator.js +448 -5
- package/lib/langium/validation/document-validator.js.map +1 -1
- package/lib/langium/workspace/document-uri-policy.d.ts +3 -4
- package/lib/langium/workspace/document-uri-policy.d.ts.map +1 -1
- package/lib/langium/workspace/document-uri-policy.js +3 -4
- package/lib/langium/workspace/document-uri-policy.js.map +1 -1
- package/lib/langium/workspace/file-system-provider.d.ts +9 -1
- package/lib/langium/workspace/file-system-provider.d.ts.map +1 -1
- package/lib/langium/workspace/file-system-provider.js +40 -7
- package/lib/langium/workspace/file-system-provider.js.map +1 -1
- package/lib/langium/workspace/hydranium-langium-document-factory.d.ts +25 -0
- package/lib/langium/workspace/hydranium-langium-document-factory.d.ts.map +1 -1
- package/lib/langium/workspace/hydranium-langium-document-factory.js +25 -0
- package/lib/langium/workspace/hydranium-langium-document-factory.js.map +1 -1
- package/lib/langium/workspace/hydranium-workspace-manager.d.ts +21 -1
- package/lib/langium/workspace/hydranium-workspace-manager.d.ts.map +1 -1
- package/lib/langium/workspace/hydranium-workspace-manager.js +28 -0
- package/lib/langium/workspace/hydranium-workspace-manager.js.map +1 -1
- package/lib/langium/workspace/in-memory-file-system-provider.d.ts +23 -0
- package/lib/langium/workspace/in-memory-file-system-provider.d.ts.map +1 -1
- package/lib/langium/workspace/in-memory-file-system-provider.js +55 -9
- package/lib/langium/workspace/in-memory-file-system-provider.js.map +1 -1
- package/lib/langium/workspace/initialize-workspace.d.ts +31 -2
- package/lib/langium/workspace/initialize-workspace.d.ts.map +1 -1
- package/lib/langium/workspace/initialize-workspace.js +13 -5
- package/lib/langium/workspace/initialize-workspace.js.map +1 -1
- package/lib/langium/workspace/langium-documents.d.ts +79 -17
- package/lib/langium/workspace/langium-documents.d.ts.map +1 -1
- package/lib/langium/workspace/langium-documents.js +83 -28
- package/lib/langium/workspace/langium-documents.js.map +1 -1
- package/lib/langium/workspace/virtual-document.d.ts +18 -3
- package/lib/langium/workspace/virtual-document.d.ts.map +1 -1
- package/lib/langium/workspace/virtual-document.js +19 -2
- package/lib/langium/workspace/virtual-document.js.map +1 -1
- package/lib/langium/workspace/write-lock-scope.d.ts +4 -3
- package/lib/langium/workspace/write-lock-scope.d.ts.map +1 -1
- package/lib/langium/workspace/write-lock-scope.js +4 -3
- package/lib/langium/workspace/write-lock-scope.js.map +1 -1
- package/lib/locale/index.d.ts +10 -0
- package/lib/locale/index.d.ts.map +1 -0
- package/lib/locale/index.js +10 -0
- package/lib/locale/index.js.map +1 -0
- package/lib/locale/server-locale.d.ts +73 -0
- package/lib/locale/server-locale.d.ts.map +1 -0
- package/lib/locale/server-locale.js +61 -0
- package/lib/locale/server-locale.js.map +1 -0
- package/lib/lsp/completion/hydranium-completion-provider.d.ts +44 -2
- package/lib/lsp/completion/hydranium-completion-provider.d.ts.map +1 -1
- package/lib/lsp/completion/hydranium-completion-provider.js +68 -0
- package/lib/lsp/completion/hydranium-completion-provider.js.map +1 -1
- package/lib/lsp/connection-features.d.ts +23 -0
- package/lib/lsp/connection-features.d.ts.map +1 -0
- package/lib/lsp/connection-features.js +60 -0
- package/lib/lsp/connection-features.js.map +1 -0
- package/lib/lsp/diagnostics-connection.d.ts +27 -0
- package/lib/lsp/diagnostics-connection.d.ts.map +1 -0
- package/lib/lsp/diagnostics-connection.js +53 -0
- package/lib/lsp/diagnostics-connection.js.map +1 -0
- package/lib/lsp/hydranium-document-update-handler.d.ts +70 -62
- package/lib/lsp/hydranium-document-update-handler.d.ts.map +1 -1
- package/lib/lsp/hydranium-document-update-handler.js +129 -75
- package/lib/lsp/hydranium-document-update-handler.js.map +1 -1
- package/lib/lsp/index.d.ts +3 -1
- package/lib/lsp/index.d.ts.map +1 -1
- package/lib/lsp/index.js +3 -1
- package/lib/lsp/index.js.map +1 -1
- package/lib/lsp/lsp-latency.d.ts +39 -0
- package/lib/lsp/lsp-latency.d.ts.map +1 -0
- package/lib/lsp/lsp-latency.js +58 -0
- package/lib/lsp/lsp-latency.js.map +1 -0
- package/lib/lsp/semantic-token-provider.d.ts +34 -1
- package/lib/lsp/semantic-token-provider.d.ts.map +1 -1
- package/lib/lsp/semantic-token-provider.js +55 -8
- package/lib/lsp/semantic-token-provider.js.map +1 -1
- package/lib/lsp/shared-module.d.ts +4 -8
- package/lib/lsp/shared-module.d.ts.map +1 -1
- package/lib/lsp/shared-module.js.map +1 -1
- package/lib/lsp/start-language-server.d.ts +8 -7
- package/lib/lsp/start-language-server.d.ts.map +1 -1
- package/lib/lsp/start-language-server.js +13 -7
- package/lib/lsp/start-language-server.js.map +1 -1
- package/lib/messages/carriers.d.ts +54 -0
- package/lib/messages/carriers.d.ts.map +1 -0
- package/lib/messages/carriers.js +62 -0
- package/lib/messages/carriers.js.map +1 -0
- package/lib/messages/index.d.ts +25 -0
- package/lib/messages/index.d.ts.map +1 -0
- package/lib/messages/index.js +25 -0
- package/lib/messages/index.js.map +1 -0
- package/lib/messages/renderer.d.ts +142 -0
- package/lib/messages/renderer.d.ts.map +1 -0
- package/lib/messages/renderer.js +165 -0
- package/lib/messages/renderer.js.map +1 -0
- package/lib/node/heap-ceiling.d.ts +61 -0
- package/lib/node/heap-ceiling.d.ts.map +1 -0
- package/lib/node/heap-ceiling.js +72 -0
- package/lib/node/heap-ceiling.js.map +1 -0
- package/lib/node/index.d.ts +1 -0
- package/lib/node/index.d.ts.map +1 -1
- package/lib/node/index.js +1 -0
- package/lib/node/index.js.map +1 -1
- package/lib/node/latency-from-env.d.ts +1 -1
- package/lib/node/latency-from-env.js +1 -1
- package/lib/node/measure-memory.d.ts.map +1 -1
- package/lib/node/measure-memory.js +1 -0
- package/lib/node/measure-memory.js.map +1 -1
- package/lib/node/node-file-system-provider.d.ts +35 -1
- package/lib/node/node-file-system-provider.d.ts.map +1 -1
- package/lib/node/node-file-system-provider.js +140 -45
- package/lib/node/node-file-system-provider.js.map +1 -1
- package/lib/node/profile-capture.d.ts +8 -2
- package/lib/node/profile-capture.d.ts.map +1 -1
- package/lib/node/profile-capture.js.map +1 -1
- package/lib/node/profiling-run.d.ts +2 -2
- package/lib/node/profiling-run.js +1 -1
- package/lib/node/profiling-run.js.map +1 -1
- package/lib/node/rename-over-open-readers.d.ts +52 -0
- package/lib/node/rename-over-open-readers.d.ts.map +1 -0
- package/lib/node/rename-over-open-readers.js +66 -0
- package/lib/node/rename-over-open-readers.js.map +1 -0
- package/lib/node/socket-launcher.d.ts +16 -1
- package/lib/node/socket-launcher.d.ts.map +1 -1
- package/lib/node/socket-launcher.js +4 -3
- package/lib/node/socket-launcher.js.map +1 -1
- package/lib/node/stdio-launcher.d.ts +1 -1
- package/lib/node/stdio-launcher.d.ts.map +1 -1
- package/lib/node/stdio-launcher.js +1 -1
- package/lib/node/stdio-launcher.js.map +1 -1
- package/lib/testing/fake-document.d.ts +16 -4
- package/lib/testing/fake-document.d.ts.map +1 -1
- package/lib/testing/fake-document.js +18 -3
- package/lib/testing/fake-document.js.map +1 -1
- package/lib/testing/make-noop-shared-services.d.ts +14 -0
- package/lib/testing/make-noop-shared-services.d.ts.map +1 -1
- package/lib/testing/make-noop-shared-services.js +28 -2
- package/lib/testing/make-noop-shared-services.js.map +1 -1
- package/lib/testing/make-test-services.d.ts +62 -14
- package/lib/testing/make-test-services.d.ts.map +1 -1
- package/lib/testing/make-test-services.js +25 -5
- package/lib/testing/make-test-services.js.map +1 -1
- package/lib/testing/node/index.d.ts +1 -0
- package/lib/testing/node/index.d.ts.map +1 -1
- package/lib/testing/node/index.js +1 -0
- package/lib/testing/node/index.js.map +1 -1
- package/lib/testing/node/lsp-harness.d.ts.map +1 -1
- package/lib/testing/node/lsp-harness.js +2 -0
- package/lib/testing/node/lsp-harness.js.map +1 -1
- package/lib/testing/node/lsp-server-connection.d.ts +11 -3
- package/lib/testing/node/lsp-server-connection.d.ts.map +1 -1
- package/lib/testing/node/lsp-server-connection.js +42 -9
- package/lib/testing/node/lsp-server-connection.js.map +1 -1
- package/lib/testing/node/scratch-workspace.d.ts.map +1 -1
- package/lib/testing/node/scratch-workspace.js +10 -5
- package/lib/testing/node/scratch-workspace.js.map +1 -1
- package/lib/testing/node/spawned-server.d.ts +14 -0
- package/lib/testing/node/spawned-server.d.ts.map +1 -1
- package/lib/testing/node/spawned-server.js +33 -1
- package/lib/testing/node/spawned-server.js.map +1 -1
- package/lib/testing/node/unhandled-rejections.d.ts +20 -0
- package/lib/testing/node/unhandled-rejections.d.ts.map +1 -0
- package/lib/testing/node/unhandled-rejections.js +32 -0
- package/lib/testing/node/unhandled-rejections.js.map +1 -0
- package/lib/testing/playwright/flaky-network-proxy.d.ts +76 -0
- package/lib/testing/playwright/flaky-network-proxy.d.ts.map +1 -0
- package/lib/testing/playwright/flaky-network-proxy.js +164 -0
- package/lib/testing/playwright/flaky-network-proxy.js.map +1 -0
- package/lib/testing/playwright/index.d.ts +1 -0
- package/lib/testing/playwright/index.d.ts.map +1 -1
- package/lib/testing/playwright/index.js +1 -0
- package/lib/testing/playwright/index.js.map +1 -1
- package/lib/testing/playwright/server-log-capture.d.ts +14 -4
- package/lib/testing/playwright/server-log-capture.d.ts.map +1 -1
- package/lib/testing/playwright/server-log-capture.js +21 -4
- package/lib/testing/playwright/server-log-capture.js.map +1 -1
- package/lib/testing/playwright/server-log-rename-reporter.d.ts.map +1 -1
- package/lib/testing/playwright/server-log-rename-reporter.js +10 -1
- package/lib/testing/playwright/server-log-rename-reporter.js.map +1 -1
- package/lib/testing/run-update-pipeline.d.ts +4 -4
- package/lib/testing/run-update-pipeline.d.ts.map +1 -1
- package/lib/testing/stub-ast-document-manager.d.ts +10 -9
- package/lib/testing/stub-ast-document-manager.d.ts.map +1 -1
- package/lib/testing/stub-ast-document-manager.js +17 -9
- package/lib/testing/stub-ast-document-manager.js.map +1 -1
- package/lib/testing/stub-document-builder.d.ts +15 -6
- package/lib/testing/stub-document-builder.d.ts.map +1 -1
- package/lib/testing/stub-document-builder.js +48 -3
- package/lib/testing/stub-document-builder.js.map +1 -1
- package/lib/testing/stub-hydranium-text-documents.d.ts +22 -7
- package/lib/testing/stub-hydranium-text-documents.d.ts.map +1 -1
- package/lib/testing/stub-hydranium-text-documents.js +92 -15
- package/lib/testing/stub-hydranium-text-documents.js.map +1 -1
- package/lib/testing/stub-langium-documents.d.ts +3 -2
- package/lib/testing/stub-langium-documents.d.ts.map +1 -1
- package/lib/testing/stub-langium-documents.js.map +1 -1
- package/lib/testing/stub-model-service.d.ts +7 -6
- package/lib/testing/stub-model-service.d.ts.map +1 -1
- package/lib/testing/stub-model-service.js +4 -4
- package/lib/testing/stub-model-service.js.map +1 -1
- package/lib/util/connection-liveness.d.ts +7 -6
- package/lib/util/connection-liveness.d.ts.map +1 -1
- package/lib/util/connection-liveness.js +35 -14
- package/lib/util/connection-liveness.js.map +1 -1
- package/package.json +17 -8
- package/src/documents/ast-document-manager.ts +345 -62
- package/src/documents/client-ids.ts +5 -22
- package/src/documents/client-session-errors.ts +24 -0
- package/src/documents/client-session-registry.ts +240 -0
- package/src/documents/file-system-task-queue.ts +68 -0
- package/src/documents/hydranium-text-documents.ts +853 -142
- package/src/documents/index.ts +3 -0
- package/src/documents/language-client-text-shadow.ts +59 -11
- package/src/documents/self-save-registry.ts +52 -13
- package/src/index.ts +6 -0
- package/src/langium/ast-extension/ast-node-builder.ts +66 -22
- package/src/langium/bootstrap.ts +16 -9
- package/src/langium/config/configuration-provider.ts +119 -0
- package/src/langium/config/index.ts +1 -0
- package/src/langium/diagnostics/lsp-logger.ts +41 -6
- package/src/langium/document-builder/build-pipeline-integration.ts +50 -5
- package/src/langium/document-builder/build-session.ts +87 -0
- package/src/langium/document-builder/document-builder.ts +460 -26
- package/src/langium/document-builder/index.ts +1 -0
- package/src/langium/integration-services.ts +67 -6
- package/src/langium/integrity/integrity-rule.ts +13 -5
- package/src/langium/integrity/integrity-service.ts +202 -17
- package/src/langium/keys/containment.ts +87 -0
- package/src/langium/keys/index.ts +1 -0
- package/src/langium/keys/name-based-key-provider.ts +4 -0
- package/src/langium/language-module.ts +42 -4
- package/src/langium/model-service/client-session.ts +606 -0
- package/src/langium/model-service/index.ts +1 -0
- package/src/langium/model-service/model-service.ts +363 -312
- package/src/langium/module.ts +132 -24
- package/src/langium/naming/name-provider.ts +27 -5
- package/src/langium/naming/name-separator-validation.ts +34 -5
- package/src/langium/residency/cst-residency-service.ts +36 -14
- package/src/langium/scope/hydranium-scope-provider.ts +60 -22
- package/src/langium/serialization/abstract-serializer.ts +13 -32
- package/src/langium/service-registry.ts +19 -2
- package/src/langium/shared-services.ts +19 -2
- package/src/langium/transfer/transfer-encoder.ts +85 -24
- package/src/langium/trivia/comment-preserver.ts +1100 -0
- package/src/langium/trivia/document-ending-preserver.ts +55 -0
- package/src/langium/trivia/index.ts +14 -0
- package/src/langium/trivia/trivia-contribution.ts +39 -0
- package/src/langium/trivia/trivia-preserver.ts +54 -0
- package/src/langium/trivia/trivia-service.ts +99 -0
- package/src/langium/update-rewrite/update-rewrite.ts +1 -1
- package/src/langium/validation/document-validator.ts +537 -11
- package/src/langium/workspace/document-uri-policy.ts +3 -4
- package/src/langium/workspace/file-system-provider.ts +48 -8
- package/src/langium/workspace/hydranium-langium-document-factory.ts +34 -0
- package/src/langium/workspace/hydranium-workspace-manager.ts +30 -1
- package/src/langium/workspace/in-memory-file-system-provider.ts +62 -10
- package/src/langium/workspace/initialize-workspace.ts +43 -5
- package/src/langium/workspace/langium-documents.ts +106 -33
- package/src/langium/workspace/virtual-document.ts +21 -3
- package/src/langium/workspace/write-lock-scope.ts +4 -3
- package/src/locale/index.ts +10 -0
- package/src/locale/server-locale.ts +86 -0
- package/src/lsp/completion/hydranium-completion-provider.ts +82 -2
- package/src/lsp/connection-features.ts +67 -0
- package/src/lsp/diagnostics-connection.ts +56 -0
- package/src/lsp/hydranium-document-update-handler.ts +158 -79
- package/src/lsp/index.ts +3 -1
- package/src/lsp/lsp-latency.ts +62 -0
- package/src/lsp/semantic-token-provider.ts +74 -7
- package/src/lsp/shared-module.ts +4 -8
- package/src/lsp/start-language-server.ts +13 -7
- package/src/messages/carriers.ts +78 -0
- package/src/messages/index.ts +36 -0
- package/src/messages/renderer.ts +212 -0
- package/src/node/heap-ceiling.ts +108 -0
- package/src/node/index.ts +1 -0
- package/src/node/latency-from-env.ts +1 -1
- package/src/node/measure-memory.ts +1 -0
- package/src/node/node-file-system-provider.ts +154 -47
- package/src/node/profile-capture.ts +8 -2
- package/src/node/profiling-run.ts +3 -3
- package/src/node/rename-over-open-readers.ts +78 -0
- package/src/node/socket-launcher.ts +19 -4
- package/src/node/stdio-launcher.ts +1 -2
- package/src/testing/fake-document.ts +24 -5
- package/src/testing/make-noop-shared-services.ts +50 -2
- package/src/testing/make-test-services.ts +101 -26
- package/src/testing/node/index.ts +1 -0
- package/src/testing/node/lsp-harness.ts +2 -0
- package/src/testing/node/lsp-server-connection.ts +61 -11
- package/src/testing/node/scratch-workspace.ts +10 -5
- package/src/testing/node/spawned-server.ts +35 -1
- package/src/testing/node/unhandled-rejections.ts +31 -0
- package/src/testing/playwright/flaky-network-proxy.ts +240 -0
- package/src/testing/playwright/index.ts +1 -0
- package/src/testing/playwright/server-log-capture.ts +24 -5
- package/src/testing/playwright/server-log-rename-reporter.ts +12 -1
- package/src/testing/run-update-pipeline.ts +4 -4
- package/src/testing/stub-ast-document-manager.ts +28 -21
- package/src/testing/stub-document-builder.ts +68 -12
- package/src/testing/stub-hydranium-text-documents.ts +127 -22
- package/src/testing/stub-langium-documents.ts +3 -2
- package/src/testing/stub-model-service.ts +9 -8
- package/src/util/connection-liveness.ts +37 -14
- package/lib/lsp/instrument-connection.d.ts +0 -36
- package/lib/lsp/instrument-connection.d.ts.map +0 -1
- package/lib/lsp/instrument-connection.js +0 -62
- package/lib/lsp/instrument-connection.js.map +0 -1
- package/src/lsp/instrument-connection.ts +0 -66
|
@@ -7,14 +7,29 @@
|
|
|
7
7
|
* SPDX-License-Identifier: MIT
|
|
8
8
|
********************************************************************************/
|
|
9
9
|
import { type Clock, type LogThreshold, type MaybeObservableValue, ObservableValue, type Tracer } from '@hydranium/protocol';
|
|
10
|
-
import { type BuildOptions, DefaultDocumentBuilder, type DocumentPhaseListener, DocumentState, type LangiumDocument, type URI } from '@hydranium/langium';
|
|
11
|
-
import { CancellationToken } from 'vscode-languageserver-protocol';
|
|
10
|
+
import { type AstNode, type BuildOptions, DefaultDocumentBuilder, type DocumentPhaseListener, DocumentState, type LangiumDocument, MultiMap, type URI, type WorkspaceLock } from '@hydranium/langium';
|
|
11
|
+
import { CancellationToken, Disposable } from 'vscode-languageserver-protocol';
|
|
12
12
|
import { type LogNameOptions } from '../diagnostics/logger.js';
|
|
13
|
+
import type { MessageRenderer } from '../../messages/renderer.js';
|
|
13
14
|
import { type ExtendedServiceRegistry } from '../service-registry.js';
|
|
14
15
|
import { type ServerSharedServicesMinimal } from '../shared-services.js';
|
|
15
16
|
import { type DocumentUriPolicy } from '../workspace/document-uri-policy.js';
|
|
17
|
+
import { BuildSession, type BuildSessionContext } from './build-session.js';
|
|
16
18
|
/** Document states a phase-reached line is emitted for by default — every built phase. */
|
|
17
19
|
export declare const DEFAULT_LOGGED_PHASES: DocumentState[];
|
|
20
|
+
/**
|
|
21
|
+
* The build reasons the framework stages through
|
|
22
|
+
* {@link HydraniumDocumentBuilder.markNextReason}: the LSP events the update
|
|
23
|
+
* handler dispatches on, and `didClose` for the revert the text store runs
|
|
24
|
+
* after a last close. Exposed so a subclass layering reasons of its own keeps
|
|
25
|
+
* the names the framework emits.
|
|
26
|
+
*/
|
|
27
|
+
export declare const HYDRANIUM_BUILD_REASONS: Readonly<{
|
|
28
|
+
readonly didOpen: "didOpen";
|
|
29
|
+
readonly didChangeContent: "didChangeContent";
|
|
30
|
+
readonly didChangeWatchedFiles: "didChangeWatchedFiles";
|
|
31
|
+
readonly didClose: "didClose";
|
|
32
|
+
}>;
|
|
18
33
|
/** Constructor options for {@link HydraniumDocumentBuilder}. */
|
|
19
34
|
export interface DocumentBuilderOptions extends LogNameOptions {
|
|
20
35
|
/**
|
|
@@ -46,6 +61,18 @@ export interface DocumentBuilderOptions extends LogNameOptions {
|
|
|
46
61
|
* logged. Default: `25`. Read per phase; accepts a {@link MaybeObservableValue}.
|
|
47
62
|
*/
|
|
48
63
|
readonly slowBuildMs?: MaybeObservableValue<number>;
|
|
64
|
+
/**
|
|
65
|
+
* Build duration at or above which a build's phase-reached and slow-listener
|
|
66
|
+
* lines are emitted; they are held for the duration of the build and dropped
|
|
67
|
+
* when it finishes faster. Default `0` — no buffering, every line emitted as
|
|
68
|
+
* it is produced, which is the only setting that keeps lines interleaved with
|
|
69
|
+
* the rest of the log in real time.
|
|
70
|
+
*
|
|
71
|
+
* Set it to make a fast rebuild log nothing but its one build line. The
|
|
72
|
+
* decision needs the build's TOTAL duration, so it cannot be made by any
|
|
73
|
+
* per-line hook. Read once per build; accepts a {@link MaybeObservableValue}.
|
|
74
|
+
*/
|
|
75
|
+
readonly phaseDetailMs?: MaybeObservableValue<number>;
|
|
49
76
|
/**
|
|
50
77
|
* Refresh cross-document `ComputedScopes` derivations when a referencing
|
|
51
78
|
* document is cascade-rebuilt (see
|
|
@@ -62,7 +89,8 @@ export interface DocumentBuilderOptions extends LogNameOptions {
|
|
|
62
89
|
* Extends Langium's {@link DefaultDocumentBuilder} with:
|
|
63
90
|
*
|
|
64
91
|
* - **Bug-fixes** (always on): an {@link awaitDocumentState} that waits where
|
|
65
|
-
* the default rejects,
|
|
92
|
+
* the default rejects (re-queuing, under the workspace lock, a document no
|
|
93
|
+
* build will carry), a {@link prepareBuild} that keeps a cancelled
|
|
66
94
|
* non-validating build from suppressing validation, and a
|
|
67
95
|
* {@link shouldRelink} that never judges a document unaffected on an index
|
|
68
96
|
* that does not describe it.
|
|
@@ -72,15 +100,24 @@ export interface DocumentBuilderOptions extends LogNameOptions {
|
|
|
72
100
|
* - **In-place rebuild helpers** — {@link reparse} and
|
|
73
101
|
* {@link reparseAndRelink} — for a build-phase listener that mutated a
|
|
74
102
|
* document's AST and must reconcile it within the same build.
|
|
75
|
-
* - **Diagnostic dedupe** at `Validated` ({@link dedupeDiagnostics})
|
|
103
|
+
* - **Diagnostic dedupe** at `Validated` ({@link dedupeDiagnostics}), followed
|
|
104
|
+
* by the **one server-side message render** every head inherits
|
|
105
|
+
* ({@link renderDiagnostics}).
|
|
106
|
+
* - **Build sessions** ({@link BuildSession}): each `update` / `build` call is
|
|
107
|
+
* one correlated unit carrying an id, a trigger label, a start time and
|
|
108
|
+
* cancellation lineage, so every line of a rebuild reads as belonging to it
|
|
109
|
+
* and a preempted build is distinguishable from the winner.
|
|
76
110
|
* - **Logging instrumentation** (default on, opt-out via `logLevel: 'off'`):
|
|
77
|
-
* phase-reached lines, slow-listener breakdowns on
|
|
78
|
-
* and slow-build-phase totals on `notifyBuildPhase`.
|
|
111
|
+
* a per-build line, phase-reached lines, slow-listener breakdowns on
|
|
112
|
+
* `notifyDocumentPhase`, and slow-build-phase totals on `notifyBuildPhase`.
|
|
79
113
|
*
|
|
80
114
|
* Adopters extend this class — the configuration knobs cover what most
|
|
81
115
|
* adopters need; the `format*Line` methods, `formatUri`, and
|
|
82
116
|
* `collectDeletedURIs` are protected so subclasses can customise wording or
|
|
83
|
-
* domain-aware cascades without re-implementing surrounding logic.
|
|
117
|
+
* domain-aware cascades without re-implementing surrounding logic. An adopter
|
|
118
|
+
* with build-scoped state of its own subclasses {@link BuildSession} and
|
|
119
|
+
* overrides {@link createBuildSession}, which puts that state under the same
|
|
120
|
+
* preemption-correct teardown rather than a reimplementation of it.
|
|
84
121
|
*/
|
|
85
122
|
export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
86
123
|
protected readonly tracer: Tracer;
|
|
@@ -94,8 +131,13 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
94
131
|
protected readonly slowListenerMs: ObservableValue<number>;
|
|
95
132
|
/** Live slow-build-phase-total threshold; read `.value` per phase. */
|
|
96
133
|
protected readonly slowBuildMs: ObservableValue<number>;
|
|
134
|
+
/** Live phase-detail buffering threshold; read `.value` once per build, onto the session. */
|
|
135
|
+
protected readonly phaseDetailMs: ObservableValue<number>;
|
|
97
136
|
protected readonly uriPolicy: DocumentUriPolicy;
|
|
98
137
|
protected readonly clock: Clock;
|
|
138
|
+
protected readonly messageRenderer: MessageRenderer;
|
|
139
|
+
/** The lock a re-queued build takes; see {@link requeueOrphaned}. */
|
|
140
|
+
protected readonly workspaceLock: WorkspaceLock;
|
|
99
141
|
/** Narrower handle on the same registry as the inherited `serviceRegistry`, for {@link ExtendedServiceRegistry.registrations}. */
|
|
100
142
|
protected readonly languageRegistry: ExtendedServiceRegistry;
|
|
101
143
|
protected languageFileExtensions: string[];
|
|
@@ -106,11 +148,29 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
106
148
|
protected readonly refreshCrossDocumentComputedScopes: boolean;
|
|
107
149
|
/** LSP event name (e.g. `'didChangeWatchedFiles'`) staged for the next `update()` call. */
|
|
108
150
|
protected pendingUpdateReason?: string;
|
|
151
|
+
/**
|
|
152
|
+
* The build currently in progress, or `undefined` between builds.
|
|
153
|
+
*
|
|
154
|
+
* A subclass carrying its own build-scoped state returns a {@link BuildSession}
|
|
155
|
+
* subclass from {@link createBuildSession} and narrows this with a typeguard
|
|
156
|
+
* where it reads that state — rather than redeclaring the field, whose
|
|
157
|
+
* initialiser would run after `super()` and clear a session opened during
|
|
158
|
+
* construction.
|
|
159
|
+
*/
|
|
160
|
+
protected activeSession?: BuildSession;
|
|
161
|
+
/**
|
|
162
|
+
* `traceId` of the last build that ended in cancellation, for the successor's
|
|
163
|
+
* "cancels #N" tag. Held here rather than on a session because the session
|
|
164
|
+
* that carries it is already gone by the time its successor is opened.
|
|
165
|
+
*/
|
|
166
|
+
protected lastCancelledTraceId?: number;
|
|
167
|
+
/** Registered through {@link onDocumentPhaseDelivered}, by phase. */
|
|
168
|
+
protected readonly documentPhaseDeliveredListeners: MultiMap<DocumentState, (document: LangiumDocument, version: number) => void>;
|
|
109
169
|
constructor(services: ServerSharedServicesMinimal, options?: DocumentBuilderOptions);
|
|
110
170
|
/**
|
|
111
171
|
* Stage an LSP event name for the next `update()` call. Adopters call before
|
|
112
|
-
* the update fires; `HydraniumDocumentUpdateHandler` does it for the
|
|
113
|
-
*
|
|
172
|
+
* the update fires; `HydraniumDocumentUpdateHandler` does it for the LSP
|
|
173
|
+
* events, and the text store for the revert that follows a last close.
|
|
114
174
|
*
|
|
115
175
|
* The framework stages the value and never reads it back. The consumer is a
|
|
116
176
|
* subclass overriding the build logging, which takes
|
|
@@ -119,6 +179,20 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
119
179
|
* with no read — that is the seam working, not a dead field.
|
|
120
180
|
*/
|
|
121
181
|
markNextReason(reason: string | undefined): void;
|
|
182
|
+
/**
|
|
183
|
+
* Call `listener` with a document once every {@link onDocumentPhase}
|
|
184
|
+
* listener of `state` ran for it and none was skipped by cancellation, and
|
|
185
|
+
* with the text version the phase listeners were called at. A write during
|
|
186
|
+
* them moves the document's own version on, past what they saw.
|
|
187
|
+
*
|
|
188
|
+
* Only here is it known what the phase listeners delivered. Langium sets the
|
|
189
|
+
* document's state before it notifies, and a cancel between two listeners
|
|
190
|
+
* skips the rest, leaving the document at the phase with those listeners
|
|
191
|
+
* never run and nothing to run them later. A build-phase listener comes too
|
|
192
|
+
* late: a cancel after this document but before the batch ends skips it,
|
|
193
|
+
* although every listener of this document ran.
|
|
194
|
+
*/
|
|
195
|
+
onDocumentPhaseDelivered(state: DocumentState, listener: (document: LangiumDocument, version: number) => void): Disposable;
|
|
122
196
|
/**
|
|
123
197
|
* Diagnostic snapshot for use in timeout/error messages around document
|
|
124
198
|
* state.
|
|
@@ -130,6 +204,8 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
130
204
|
* duplicate what this already knows.
|
|
131
205
|
*/
|
|
132
206
|
formatBuildStatus(uri: URI): string;
|
|
207
|
+
/** Render a session for a status line. `undefined` — no build in progress — reads as `none`. */
|
|
208
|
+
protected formatSession(session: BuildSession | undefined): string;
|
|
133
209
|
/**
|
|
134
210
|
* Two edge cases the default Langium implementation rejects on:
|
|
135
211
|
* - Document below target state with no build active (newly-created file):
|
|
@@ -151,8 +227,29 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
151
227
|
* {@link MAX_STALLED_REQUEUES} builds that fail to advance the document, so a
|
|
152
228
|
* document the builder will never carry to `state` degrades to a pending wait
|
|
153
229
|
* plus a warning rather than an endless build loop.
|
|
230
|
+
*
|
|
231
|
+
* A wait for `Validated` on a document that a validating build skips
|
|
232
|
+
* resolves once that build has indexed its references, without diagnostics:
|
|
233
|
+
* see {@link skipsValidation}. Waiting on would never end, and re-queuing
|
|
234
|
+
* would skip it again.
|
|
235
|
+
*
|
|
236
|
+
* A re-queued build takes the {@link WorkspaceLock} (see
|
|
237
|
+
* {@link requeueOrphaned}), so a caller that awaits this wait while it holds
|
|
238
|
+
* the lock, inside a read or write action, deadlocks on a document that needs
|
|
239
|
+
* a re-queue: the build waits for that action to end. Await it outside the
|
|
240
|
+
* lock.
|
|
154
241
|
*/
|
|
155
242
|
protected awaitDocumentState(state: DocumentState, uri: URI, cancelToken: CancellationToken): Promise<URI>;
|
|
243
|
+
/**
|
|
244
|
+
* Whether the build that carries or last carried `document` has indexed its
|
|
245
|
+
* references, asks for validation, and still skips it, which is an override
|
|
246
|
+
* of `shouldValidate` excluding it. A build that does not ask for
|
|
247
|
+
* validation, such as the workspace's initial one, is not a skip: the next
|
|
248
|
+
* validating build validates the document. Nor is a document below
|
|
249
|
+
* `IndexedReferences`: the build writes its options before the first phase,
|
|
250
|
+
* so the document would pass for skipped before it is even parsed.
|
|
251
|
+
*/
|
|
252
|
+
protected skipsValidation(document: LangiumDocument): boolean;
|
|
156
253
|
/**
|
|
157
254
|
* Whether no build will advance `document` to `state`, so a wait on it can
|
|
158
255
|
* only be resolved by starting one.
|
|
@@ -179,6 +276,18 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
179
276
|
* notification, so awaiting here would invert the dependency. A rejection is
|
|
180
277
|
* logged rather than swallowed — it leaves the waiter pending until its own
|
|
181
278
|
* cancellation token fires, which is worth a line in the log.
|
|
279
|
+
*
|
|
280
|
+
* The build is an ordinary {@link WorkspaceLock} write, entered from a read.
|
|
281
|
+
* The read waits until no write runs or is queued, so the build neither runs
|
|
282
|
+
* beside a locked one nor cancels the build a re-queue is fired from. Unlocked,
|
|
283
|
+
* it runs beside a locked build that cannot cancel it: both validate the same
|
|
284
|
+
* version and deliver it twice. Taking the write directly, without the read,
|
|
285
|
+
* cancels the running build and skips the rest of its build-phase listeners.
|
|
286
|
+
* The read must not await the write, which queues behind that read.
|
|
287
|
+
*
|
|
288
|
+
* A write that ran while the read waited may have carried the document to
|
|
289
|
+
* `state` already, and a second build would deliver that version again; the
|
|
290
|
+
* read skips the write then.
|
|
182
291
|
*/
|
|
183
292
|
protected requeueOrphaned(document: LangiumDocument, state: DocumentState, reason: string): void;
|
|
184
293
|
/**
|
|
@@ -228,6 +337,12 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
228
337
|
*/
|
|
229
338
|
protected shouldRelink(document: LangiumDocument, changedUris: Set<string>): boolean;
|
|
230
339
|
update(changed: URI[], deleted: URI[], cancelToken?: CancellationToken): Promise<void>;
|
|
340
|
+
/**
|
|
341
|
+
* The workspace-initialization entry point, bracketed by a session like
|
|
342
|
+
* {@link update}. Langium's `update` reaches `buildDocuments` directly rather
|
|
343
|
+
* than through here, so the two never nest.
|
|
344
|
+
*/
|
|
345
|
+
build<T extends AstNode>(documents: Array<LangiumDocument<T>>, options?: BuildOptions, cancelToken?: CancellationToken): Promise<void>;
|
|
231
346
|
/**
|
|
232
347
|
* Refresh cross-document `ComputedScopes` derivations on cascade, when
|
|
233
348
|
* {@link refreshCrossDocumentComputedScopes} is set (default off).
|
|
@@ -340,10 +455,66 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
340
455
|
* project descriptor should cascade to all its members).
|
|
341
456
|
*/
|
|
342
457
|
protected collectDeletedURIs(uri: URI): URI[];
|
|
458
|
+
/**
|
|
459
|
+
* Open a session, run `body` inside it, and close it — the bracket every
|
|
460
|
+
* line of a rebuild is emitted within.
|
|
461
|
+
*
|
|
462
|
+
* The session is installed **synchronously**, before the timed body runs, so
|
|
463
|
+
* that state a subclass computed in {@link createBuildSession} is already
|
|
464
|
+
* readable by the time Langium's `update` consults `shouldRelink`.
|
|
465
|
+
*
|
|
466
|
+
* Teardown is preemption-correct, which is the reason this is framework code
|
|
467
|
+
* rather than a recipe. A build outside the workspace lock overlaps another:
|
|
468
|
+
* the later one installs itself as {@link activeSession} while the earlier
|
|
469
|
+
* one is still running, and the earlier one's `finally` runs LAST. Clearing
|
|
470
|
+
* unconditionally there would discard the later build's state mid-build.
|
|
471
|
+
* Only the session that is still current clears — and the check is
|
|
472
|
+
* reference equality on the session object,
|
|
473
|
+
* not on {@link BuildSession.traceId}, which is `undefined` for every build
|
|
474
|
+
* whenever the timing level is suppressed and would compare equal to itself
|
|
475
|
+
* across two different builds.
|
|
476
|
+
*
|
|
477
|
+
* Builds outside the lock are not hypothetical even without an adopter: the
|
|
478
|
+
* model service with `serializeBuilds` off starts one. Two locked builds
|
|
479
|
+
* never overlap, since the lock starts a write only once the write it
|
|
480
|
+
* cancelled has unwound.
|
|
481
|
+
*/
|
|
482
|
+
protected runInSession(context: BuildSessionContext, label: string, body: () => Promise<void>): Promise<void>;
|
|
483
|
+
/**
|
|
484
|
+
* Construct the session for one build. Override to return a
|
|
485
|
+
* {@link BuildSession} subclass carrying adopter build-scoped state — it is
|
|
486
|
+
* called before the build body, so anything derived here is readable
|
|
487
|
+
* throughout it.
|
|
488
|
+
*/
|
|
489
|
+
protected createBuildSession(context: BuildSessionContext): BuildSession;
|
|
490
|
+
/**
|
|
491
|
+
* Close `session`: flush what it buffered, then release it if it is still the
|
|
492
|
+
* current one (see {@link runInSession} on why that check is conditional).
|
|
493
|
+
* The flush is unconditional — a preempted build's lines still describe work
|
|
494
|
+
* that happened.
|
|
495
|
+
*/
|
|
496
|
+
protected endSession(session: BuildSession): void;
|
|
497
|
+
/**
|
|
498
|
+
* Emit the lines `session` held back, if it ran long enough to be worth the
|
|
499
|
+
* detail; drop them otherwise. Emits through {@link emit} rather than
|
|
500
|
+
* {@link log}, which would route them straight back into the buffer.
|
|
501
|
+
*/
|
|
502
|
+
protected flushSession(session: BuildSession): void;
|
|
503
|
+
/** Label for the build's own log line. Override to customise wording. */
|
|
504
|
+
protected rebuildLabel(changed: URI[], deleted: URI[]): string;
|
|
505
|
+
/** Short description of what triggered the build, repeated on every phase line. Override to customise wording. */
|
|
506
|
+
protected buildTriggerLabel(changed: URI[], deleted: URI[]): string;
|
|
343
507
|
protected registerPhaseListeners(): void;
|
|
344
508
|
/** Called once per phase-reached event. Override to add custom side-effects beyond logging. */
|
|
345
509
|
protected onPhaseReached(state: DocumentState, documents: LangiumDocument[]): void;
|
|
346
|
-
/**
|
|
510
|
+
/**
|
|
511
|
+
* Format the phase-reached log line. Override to customise wording.
|
|
512
|
+
*
|
|
513
|
+
* Within a session the line names what triggered the build, so a phase read
|
|
514
|
+
* in isolation still says which rebuild it belongs to. `elapsedMs` is ignored
|
|
515
|
+
* for the FIRST phase of a session: it measures from the previous build's
|
|
516
|
+
* last phase, an idle gap that says nothing about this build.
|
|
517
|
+
*/
|
|
347
518
|
protected phaseReachedLine(state: DocumentState, documents: LangiumDocument[], elapsedMs: number): string;
|
|
348
519
|
notifyDocumentPhase(document: LangiumDocument, state: DocumentState, cancelToken: CancellationToken): Promise<void>;
|
|
349
520
|
/**
|
|
@@ -399,7 +570,45 @@ export declare class HydraniumDocumentBuilder extends DefaultDocumentBuilder {
|
|
|
399
570
|
* serialising anything.
|
|
400
571
|
*/
|
|
401
572
|
protected dedupeDiagnostics(document: LangiumDocument): void;
|
|
402
|
-
/**
|
|
573
|
+
/**
|
|
574
|
+
* Render every diagnostic on `document` through the bound message renderer,
|
|
575
|
+
* in ONE pass over the finished list.
|
|
576
|
+
*
|
|
577
|
+
* All three heads read `document.diagnostics` — the LSP publish,
|
|
578
|
+
* `TransferEncoder.toTransferDiagnostic` and the GLSP validation path — so
|
|
579
|
+
* one pass here is what keeps the render from happening per head. It is also
|
|
580
|
+
* the only placement that covers lexer and parser errors, which Langium
|
|
581
|
+
* pushes onto the document without routing them through `toDiagnostic`.
|
|
582
|
+
*
|
|
583
|
+
* Running here rather than from a `Validated` phase listener needs no
|
|
584
|
+
* ordering assumption: Langium publishes from `addDiagnosticsHandler`, a free
|
|
585
|
+
* function it registers as such a listener, which can only be outrun.
|
|
586
|
+
*
|
|
587
|
+
* **It inherits {@link dedupeDiagnostics}'s window, and therefore the same
|
|
588
|
+
* precondition.** A build settling inside the listener window appends
|
|
589
|
+
* diagnostics this pass never saw, and the publisher of the build that
|
|
590
|
+
* rendered sends them — unrendered. `ModelServiceOptions.serializeBuilds`
|
|
591
|
+
* closes it and defaults to `true`, so "every diagnostic is rendered" holds
|
|
592
|
+
* by default and is an opt-out rather than a guarantee. Opting out accepts
|
|
593
|
+
* unrendered diagnostics on exactly the terms it already accepts duplicates.
|
|
594
|
+
*
|
|
595
|
+
* Entries are REPLACED rather than mutated: `sendDiagnostics` passes the
|
|
596
|
+
* array by reference and serialises later, so an in-place message mutation
|
|
597
|
+
* reaches the wire even when it runs after the publisher — which would make
|
|
598
|
+
* a test for the ordering pass in either state.
|
|
599
|
+
*/
|
|
600
|
+
protected renderDiagnostics(document: LangiumDocument): void;
|
|
601
|
+
/**
|
|
602
|
+
* Dispatch a log line at the configured log level; a no-op when `logLevel ===
|
|
603
|
+
* 'off'`.
|
|
604
|
+
*
|
|
605
|
+
* Held on the active session when it buffers, so the "was this build worth a
|
|
606
|
+
* per-phase breakdown" decision — which needs the build's total duration, and
|
|
607
|
+
* so cannot be taken by anything that runs while the lines are produced — is
|
|
608
|
+
* deferred to {@link flushSession}.
|
|
609
|
+
*/
|
|
403
610
|
protected log(message: string): void;
|
|
611
|
+
/** Write a line out, bypassing session buffering. The single sink every framework log line reaches. */
|
|
612
|
+
protected emit(message: string): void;
|
|
404
613
|
}
|
|
405
614
|
//# sourceMappingURL=document-builder.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"document-builder.d.ts","sourceRoot":"","sources":["../../../src/langium/document-builder/document-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,eAAe,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7H,OAAO,EACJ,KAAK,YAAY,EACjB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,aAAa,EACb,KAAK,eAAe,
|
|
1
|
+
{"version":3,"file":"document-builder.d.ts","sourceRoot":"","sources":["../../../src/langium/document-builder/document-builder.ts"],"names":[],"mappings":"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"}
|