@alloy-js/core 0.23.0-dev.9 → 0.23.0
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 +34 -0
- package/api-extractor.json +1 -8
- package/api-extractor.testing.json +19 -0
- package/dist/dev/src/binder.js +595 -0
- package/dist/dev/src/binder.js.map +1 -0
- package/dist/dev/src/code.js +181 -0
- package/dist/dev/src/code.js.map +1 -0
- package/dist/dev/src/components/AccessExpression.js +230 -0
- package/dist/dev/src/components/AccessExpression.js.map +1 -0
- package/dist/dev/src/components/AccessExpression.test.js +237 -0
- package/dist/dev/src/components/AccessExpression.test.js.map +1 -0
- package/dist/dev/src/components/AppendFile.js +246 -0
- package/dist/dev/src/components/AppendFile.js.map +1 -0
- package/dist/dev/src/components/Block.js +78 -0
- package/dist/dev/src/components/Block.js.map +1 -0
- package/dist/dev/src/components/CopyFile.js +16 -0
- package/dist/dev/src/components/CopyFile.js.map +1 -0
- package/dist/dev/src/components/Declaration.js +70 -0
- package/dist/dev/src/components/Declaration.js.map +1 -0
- package/dist/dev/src/components/For.js +40 -0
- package/dist/dev/src/components/For.js.map +1 -0
- package/dist/dev/src/components/Indent.js +37 -0
- package/dist/dev/src/components/Indent.js.map +1 -0
- package/dist/dev/src/components/List.js +29 -0
- package/dist/dev/src/components/List.js.map +1 -0
- package/dist/dev/src/components/MemberDeclaration.js +70 -0
- package/dist/dev/src/components/MemberDeclaration.js.map +1 -0
- package/dist/dev/src/components/MemberName.js +18 -0
- package/dist/dev/src/components/MemberName.js.map +1 -0
- package/dist/dev/src/components/MemberScope.js +62 -0
- package/dist/dev/src/components/MemberScope.js.map +1 -0
- package/dist/dev/src/components/Name.js +11 -0
- package/dist/dev/src/components/Name.js.map +1 -0
- package/dist/dev/src/components/Output.js +72 -0
- package/dist/dev/src/components/Output.js.map +1 -0
- package/dist/dev/src/components/Prose.js +32 -0
- package/dist/dev/src/components/Prose.js.map +1 -0
- package/dist/dev/src/components/ReferenceOrContent.js +12 -0
- package/dist/dev/src/components/ReferenceOrContent.js.map +1 -0
- package/dist/dev/src/components/Scope.js +56 -0
- package/dist/dev/src/components/Scope.js.map +1 -0
- package/dist/dev/src/components/Show.js +4 -0
- package/dist/dev/src/components/Show.js.map +1 -0
- package/dist/dev/src/components/SourceDirectory.js +41 -0
- package/dist/dev/src/components/SourceDirectory.js.map +1 -0
- package/dist/dev/src/components/SourceFile.js +52 -0
- package/dist/dev/src/components/SourceFile.js.map +1 -0
- package/dist/dev/src/components/StatementList.js +20 -0
- package/dist/dev/src/components/StatementList.js.map +1 -0
- package/dist/dev/src/components/Switch.js +42 -0
- package/dist/dev/src/components/Switch.js.map +1 -0
- package/dist/dev/src/components/TemplateFile.js +153 -0
- package/dist/dev/src/components/TemplateFile.js.map +1 -0
- package/dist/dev/src/components/UpdateFile.js +71 -0
- package/dist/dev/src/components/UpdateFile.js.map +1 -0
- package/dist/dev/src/components/Wrap.js +18 -0
- package/dist/dev/src/components/Wrap.js.map +1 -0
- package/dist/dev/src/components/index.js +25 -0
- package/dist/dev/src/components/index.js.map +1 -0
- package/dist/dev/src/components/stc/index.js +27 -0
- package/dist/dev/src/components/stc/index.js.map +1 -0
- package/dist/dev/src/components/stc/sti.js +10 -0
- package/dist/dev/src/components/stc/sti.js.map +1 -0
- package/dist/dev/src/content-slot.js +78 -0
- package/dist/dev/src/content-slot.js.map +1 -0
- package/dist/dev/src/content-slot.test.js +89 -0
- package/dist/dev/src/content-slot.test.js.map +1 -0
- package/dist/dev/src/context/assignment.js +46 -0
- package/dist/dev/src/context/assignment.js.map +1 -0
- package/dist/dev/src/context/binder.js +17 -0
- package/dist/dev/src/context/binder.js.map +1 -0
- package/dist/dev/src/context/declaration.js +3 -0
- package/dist/dev/src/context/declaration.js.map +1 -0
- package/dist/dev/src/context/format-options.js +45 -0
- package/dist/dev/src/context/format-options.js.map +1 -0
- package/dist/dev/src/context/index.js +11 -0
- package/dist/dev/src/context/index.js.map +1 -0
- package/dist/dev/src/context/member-declaration.js +11 -0
- package/dist/dev/src/context/member-declaration.js.map +1 -0
- package/dist/dev/src/context/member-scope.js +12 -0
- package/dist/dev/src/context/member-scope.js.map +1 -0
- package/dist/dev/src/context/name-policy.js +13 -0
- package/dist/dev/src/context/name-policy.js.map +1 -0
- package/dist/dev/src/context/scope.js +18 -0
- package/dist/dev/src/context/scope.js.map +1 -0
- package/dist/dev/src/context/source-directory.js +12 -0
- package/dist/dev/src/context/source-directory.js.map +1 -0
- package/dist/dev/src/context/source-file.js +3 -0
- package/dist/dev/src/context/source-file.js.map +1 -0
- package/dist/dev/src/context.js +47 -0
- package/dist/dev/src/context.js.map +1 -0
- package/dist/dev/src/debug/cli.js +164 -0
- package/dist/dev/src/debug/cli.js.map +1 -0
- package/dist/dev/src/debug/diagnostics-broadcast.test.js +100 -0
- package/dist/dev/src/debug/diagnostics-broadcast.test.js.map +1 -0
- package/dist/dev/src/debug/diagnostics.test.js +50 -0
- package/dist/dev/src/debug/diagnostics.test.js.map +1 -0
- package/dist/dev/src/debug/effects.js +293 -0
- package/dist/dev/src/debug/effects.js.map +1 -0
- package/dist/dev/src/debug/effects.test.js +280 -0
- package/dist/dev/src/debug/effects.test.js.map +1 -0
- package/dist/dev/src/debug/files.js +29 -0
- package/dist/dev/src/debug/files.js.map +1 -0
- package/dist/dev/src/debug/files.test.js +78 -0
- package/dist/dev/src/debug/files.test.js.map +1 -0
- package/dist/dev/src/debug/index.js +71 -0
- package/dist/dev/src/debug/index.js.map +1 -0
- package/dist/dev/src/debug/message-format.test.js +836 -0
- package/dist/dev/src/debug/message-format.test.js.map +1 -0
- package/dist/dev/src/debug/render-tree-orphans.test.js +365 -0
- package/dist/dev/src/debug/render-tree-orphans.test.js.map +1 -0
- package/dist/dev/src/debug/render.js +479 -0
- package/dist/dev/src/debug/render.js.map +1 -0
- package/dist/dev/src/debug/render.test.js +363 -0
- package/dist/dev/src/debug/render.test.js.map +1 -0
- package/dist/dev/src/debug/serialize.js +70 -0
- package/dist/dev/src/debug/serialize.js.map +1 -0
- package/dist/dev/src/debug/source-map.browser.js +24 -0
- package/dist/dev/src/debug/source-map.browser.js.map +1 -0
- package/dist/dev/src/debug/source-map.js +111 -0
- package/dist/dev/src/debug/source-map.js.map +1 -0
- package/dist/dev/src/debug/symbols.js +196 -0
- package/dist/dev/src/debug/symbols.js.map +1 -0
- package/dist/dev/src/debug/symbols.test.js +93 -0
- package/dist/dev/src/debug/symbols.test.js.map +1 -0
- package/dist/dev/src/debug/trace-writer.js +674 -0
- package/dist/dev/src/debug/trace-writer.js.map +1 -0
- package/dist/dev/src/debug/trace.js +460 -0
- package/dist/dev/src/debug/trace.js.map +1 -0
- package/dist/dev/src/devtools/devtools-protocol.js +2 -0
- package/dist/dev/src/devtools/devtools-protocol.js.map +1 -0
- package/dist/dev/src/devtools/devtools-server.browser.js +36 -0
- package/dist/dev/src/devtools/devtools-server.browser.js.map +1 -0
- package/dist/dev/src/devtools/devtools-server.js +458 -0
- package/dist/dev/src/devtools/devtools-server.js.map +1 -0
- package/dist/dev/src/devtools/devtools-transport.js +114 -0
- package/dist/dev/src/devtools/devtools-transport.js.map +1 -0
- package/dist/dev/src/devtools-entry.browser.js +2 -0
- package/dist/dev/src/devtools-entry.browser.js.map +1 -0
- package/dist/dev/src/devtools-entry.js +2 -0
- package/dist/dev/src/devtools-entry.js.map +1 -0
- package/dist/dev/src/diagnostics.js +97 -0
- package/dist/dev/src/diagnostics.js.map +1 -0
- package/dist/dev/src/host/alloy-host.browser.js +32 -0
- package/dist/dev/src/host/alloy-host.browser.js.map +1 -0
- package/dist/dev/src/host/alloy-host.js +144 -0
- package/dist/dev/src/host/alloy-host.js.map +1 -0
- package/dist/dev/src/host/interface.js +2 -0
- package/dist/dev/src/host/interface.js.map +1 -0
- package/dist/dev/src/host/node-host.browser.js +21 -0
- package/dist/dev/src/host/node-host.browser.js.map +1 -0
- package/dist/dev/src/host/node-host.js +20 -0
- package/dist/dev/src/host/node-host.js.map +1 -0
- package/dist/dev/src/index.browser.js +3 -0
- package/dist/dev/src/index.browser.js.map +1 -0
- package/dist/dev/src/index.js +27 -0
- package/dist/dev/src/index.js.map +1 -0
- package/dist/dev/src/inspect.browser.js +6 -0
- package/dist/dev/src/inspect.browser.js.map +1 -0
- package/dist/dev/src/inspect.js +2 -0
- package/dist/dev/src/inspect.js.map +1 -0
- package/dist/dev/src/jsx-runtime.js +17 -0
- package/dist/dev/src/jsx-runtime.js.map +1 -0
- package/dist/dev/src/library-symbol-reference.js +59 -0
- package/dist/dev/src/library-symbol-reference.js.map +1 -0
- package/dist/dev/src/name-policy.js +51 -0
- package/dist/dev/src/name-policy.js.map +1 -0
- package/dist/dev/src/pretty-string/pretty-string.js +100 -0
- package/dist/dev/src/pretty-string/pretty-string.js.map +1 -0
- package/dist/dev/src/pretty-string/pretty-string.test.js +38 -0
- package/dist/dev/src/pretty-string/pretty-string.test.js.map +1 -0
- package/dist/dev/src/print-hook.js +10 -0
- package/dist/dev/src/print-hook.js.map +1 -0
- package/dist/dev/src/props-combinators.js +109 -0
- package/dist/dev/src/props-combinators.js.map +1 -0
- package/dist/dev/src/reactive-union-set.js +213 -0
- package/dist/dev/src/reactive-union-set.js.map +1 -0
- package/dist/dev/src/reactivity.js +452 -0
- package/dist/dev/src/reactivity.js.map +1 -0
- package/dist/dev/src/refkey.js +167 -0
- package/dist/dev/src/refkey.js.map +1 -0
- package/dist/dev/src/render-stack.js +252 -0
- package/dist/dev/src/render-stack.js.map +1 -0
- package/dist/dev/src/render.js +872 -0
- package/dist/dev/src/render.js.map +1 -0
- package/dist/dev/src/resource.js +124 -0
- package/dist/dev/src/resource.js.map +1 -0
- package/dist/dev/src/runtime/component.js +41 -0
- package/dist/dev/src/runtime/component.js.map +1 -0
- package/dist/dev/src/runtime/intrinsic.js +12 -0
- package/dist/dev/src/runtime/intrinsic.js.map +1 -0
- package/dist/dev/src/scheduler.js +217 -0
- package/dist/dev/src/scheduler.js.map +1 -0
- package/dist/dev/src/stc.js +40 -0
- package/dist/dev/src/stc.js.map +1 -0
- package/dist/dev/src/sti.js +31 -0
- package/dist/dev/src/sti.js.map +1 -0
- package/dist/dev/src/symbols/basic-scope.js +21 -0
- package/dist/dev/src/symbols/basic-scope.js.map +1 -0
- package/dist/dev/src/symbols/basic-symbol.js +34 -0
- package/dist/dev/src/symbols/basic-symbol.js.map +1 -0
- package/dist/dev/src/symbols/decl.js +26 -0
- package/dist/dev/src/symbols/decl.js.map +1 -0
- package/dist/dev/src/symbols/index.js +10 -0
- package/dist/dev/src/symbols/index.js.map +1 -0
- package/dist/dev/src/symbols/output-scope.js +235 -0
- package/dist/dev/src/symbols/output-scope.js.map +1 -0
- package/dist/dev/src/symbols/output-space.js +51 -0
- package/dist/dev/src/symbols/output-space.js.map +1 -0
- package/dist/dev/src/symbols/output-symbol.js +644 -0
- package/dist/dev/src/symbols/output-symbol.js.map +1 -0
- package/dist/dev/src/symbols/symbol-flow.js +106 -0
- package/dist/dev/src/symbols/symbol-flow.js.map +1 -0
- package/dist/dev/src/symbols/symbol-slot.js +75 -0
- package/dist/dev/src/symbols/symbol-slot.js.map +1 -0
- package/dist/dev/src/symbols/symbol-slot.test.js +68 -0
- package/dist/dev/src/symbols/symbol-slot.test.js.map +1 -0
- package/dist/dev/src/symbols/symbol-table.js +103 -0
- package/dist/dev/src/symbols/symbol-table.js.map +1 -0
- package/dist/dev/src/tap.js +109 -0
- package/dist/dev/src/tap.js.map +1 -0
- package/dist/dev/src/trace.js +2 -0
- package/dist/dev/src/trace.js.map +1 -0
- package/dist/dev/src/tracer.js +180 -0
- package/dist/dev/src/tracer.js.map +1 -0
- package/dist/dev/src/utils.js +487 -0
- package/dist/dev/src/utils.js.map +1 -0
- package/dist/dev/src/write-output.js +48 -0
- package/dist/dev/src/write-output.js.map +1 -0
- package/dist/dev/test/browser-build.test.js +85 -0
- package/dist/dev/test/browser-build.test.js.map +1 -0
- package/dist/dev/test/children.test.js +44 -0
- package/dist/dev/test/children.test.js.map +1 -0
- package/dist/dev/test/components/append-file.test.js +394 -0
- package/dist/dev/test/components/append-file.test.js.map +1 -0
- package/dist/dev/test/components/block.test.js +83 -0
- package/dist/dev/test/components/block.test.js.map +1 -0
- package/dist/dev/test/components/copy-file.test.js +119 -0
- package/dist/dev/test/components/copy-file.test.js.map +1 -0
- package/dist/dev/test/components/declaration.test.js +40 -0
- package/dist/dev/test/components/declaration.test.js.map +1 -0
- package/dist/dev/test/components/list.test.js +250 -0
- package/dist/dev/test/components/list.test.js.map +1 -0
- package/dist/dev/test/components/prose.test.js +42 -0
- package/dist/dev/test/components/prose.test.js.map +1 -0
- package/dist/dev/test/components/reference-or-content.test.js +246 -0
- package/dist/dev/test/components/reference-or-content.test.js.map +1 -0
- package/dist/dev/test/components/source-file.test.js +271 -0
- package/dist/dev/test/components/source-file.test.js.map +1 -0
- package/dist/dev/test/components/template-file.test.js +200 -0
- package/dist/dev/test/components/template-file.test.js.map +1 -0
- package/dist/dev/test/components/update-file.test.js +210 -0
- package/dist/dev/test/components/update-file.test.js.map +1 -0
- package/dist/dev/test/components/wrap.test.js +48 -0
- package/dist/dev/test/components/wrap.test.js.map +1 -0
- package/dist/dev/test/control-flow/for.test.js +318 -0
- package/dist/dev/test/control-flow/for.test.js.map +1 -0
- package/dist/dev/test/control-flow/match.test.js +112 -0
- package/dist/dev/test/control-flow/match.test.js.map +1 -0
- package/dist/dev/test/control-flow/show.test.js +38 -0
- package/dist/dev/test/control-flow/show.test.js.map +1 -0
- package/dist/dev/test/lazy-isempty.test.js +121 -0
- package/dist/dev/test/lazy-isempty.test.js.map +1 -0
- package/dist/dev/test/name-policy.test.js +28 -0
- package/dist/dev/test/name-policy.test.js.map +1 -0
- package/dist/dev/test/props-with-defaults.test.js +94 -0
- package/dist/dev/test/props-with-defaults.test.js.map +1 -0
- package/dist/dev/test/reactive-union-set-disposers.test.js +98 -0
- package/dist/dev/test/reactive-union-set-disposers.test.js.map +1 -0
- package/dist/dev/test/reactive-union-set.test.js +171 -0
- package/dist/dev/test/reactive-union-set.test.js.map +1 -0
- package/dist/dev/test/reactivity/circular-reactives.test.js +62 -0
- package/dist/dev/test/reactivity/circular-reactives.test.js.map +1 -0
- package/dist/dev/test/reactivity/cleanup.test.js +96 -0
- package/dist/dev/test/reactivity/cleanup.test.js.map +1 -0
- package/dist/dev/test/reactivity/memo.test.js +17 -0
- package/dist/dev/test/reactivity/memo.test.js.map +1 -0
- package/dist/dev/test/reactivity/ref-rendering.test.js +38 -0
- package/dist/dev/test/reactivity/ref-rendering.test.js.map +1 -0
- package/dist/dev/test/reactivity/shallow-reactive.test.js +56 -0
- package/dist/dev/test/reactivity/shallow-reactive.test.js.map +1 -0
- package/dist/dev/test/reactivity/test.test.js +74 -0
- package/dist/dev/test/reactivity/test.test.js.map +1 -0
- package/dist/dev/test/reactivity/untrack.test.js +27 -0
- package/dist/dev/test/reactivity/untrack.test.js.map +1 -0
- package/dist/dev/test/refkey.test.js +36 -0
- package/dist/dev/test/refkey.test.js.map +1 -0
- package/dist/dev/test/rendering/basic.test.js +194 -0
- package/dist/dev/test/rendering/basic.test.js.map +1 -0
- package/dist/dev/test/rendering/code.test.js +64 -0
- package/dist/dev/test/rendering/code.test.js.map +1 -0
- package/dist/dev/test/rendering/formatting.test.js +797 -0
- package/dist/dev/test/rendering/formatting.test.js.map +1 -0
- package/dist/dev/test/rendering/indent.test.js +183 -0
- package/dist/dev/test/rendering/indent.test.js.map +1 -0
- package/dist/dev/test/rendering/memoization.test.js +37 -0
- package/dist/dev/test/rendering/memoization.test.js.map +1 -0
- package/dist/dev/test/rendering/print-render-stack.test.js +287 -0
- package/dist/dev/test/rendering/print-render-stack.test.js.map +1 -0
- package/dist/dev/test/rendering/refkeys.test.js +37 -0
- package/dist/dev/test/rendering/refkeys.test.js.map +1 -0
- package/dist/dev/test/scheduler-extended.test.js +96 -0
- package/dist/dev/test/scheduler-extended.test.js.map +1 -0
- package/dist/dev/test/scheduler.test.js +46 -0
- package/dist/dev/test/scheduler.test.js.map +1 -0
- package/dist/dev/test/split-props.test.js +78 -0
- package/dist/dev/test/split-props.test.js.map +1 -0
- package/dist/dev/test/stc.test.js +35 -0
- package/dist/dev/test/stc.test.js.map +1 -0
- package/dist/dev/test/symbols/deconflicted-name.test.js +120 -0
- package/dist/dev/test/symbols/deconflicted-name.test.js.map +1 -0
- package/dist/dev/test/symbols/output-scope.test.js +221 -0
- package/dist/dev/test/symbols/output-scope.test.js.map +1 -0
- package/dist/dev/test/symbols/output-symbol.test.js +202 -0
- package/dist/dev/test/symbols/output-symbol.test.js.map +1 -0
- package/dist/dev/test/symbols/resolution.test.js +487 -0
- package/dist/dev/test/symbols/resolution.test.js.map +1 -0
- package/dist/dev/test/symbols/symbol-table.test.js +15 -0
- package/dist/dev/test/symbols/symbol-table.test.js.map +1 -0
- package/dist/dev/test/symbols/utils.js +26 -0
- package/dist/dev/test/symbols/utils.js.map +1 -0
- package/dist/dev/test/utils.test.js +317 -0
- package/dist/dev/test/utils.test.js.map +1 -0
- package/dist/dev/testing/create-test-wrapper.js +130 -0
- package/dist/dev/testing/create-test-wrapper.js.map +1 -0
- package/dist/dev/testing/devtools-utils.js +162 -0
- package/dist/dev/testing/devtools-utils.js.map +1 -0
- package/dist/dev/testing/extend-expect.js +187 -0
- package/dist/dev/testing/extend-expect.js.map +1 -0
- package/dist/dev/testing/extend-expect.test.js +234 -0
- package/dist/dev/testing/extend-expect.test.js.map +1 -0
- package/dist/dev/testing/index.js +4 -0
- package/dist/dev/testing/index.js.map +1 -0
- package/dist/dev/testing/render.js +34 -0
- package/dist/dev/testing/render.js.map +1 -0
- package/dist/dev/testing/vitest.d.js +14 -0
- package/dist/dev/testing/vitest.d.js.map +1 -0
- package/dist/devtools/index.html +29 -17
- package/dist/src/binder.d.ts +107 -3
- package/dist/src/binder.d.ts.map +1 -1
- package/dist/src/binder.js +113 -1
- package/dist/src/binder.js.map +1 -1
- package/dist/src/components/AccessExpression.d.ts +78 -0
- package/dist/src/components/AccessExpression.d.ts.map +1 -0
- package/dist/src/components/AccessExpression.js +218 -0
- package/dist/src/components/AccessExpression.js.map +1 -0
- package/dist/src/components/AccessExpression.test.d.ts +2 -0
- package/dist/src/components/AccessExpression.test.d.ts.map +1 -0
- package/dist/src/components/AccessExpression.test.js +137 -0
- package/dist/src/components/AccessExpression.test.js.map +1 -0
- package/dist/src/components/Block.d.ts +12 -0
- package/dist/src/components/Block.d.ts.map +1 -1
- package/dist/src/components/Block.js +12 -0
- package/dist/src/components/Block.js.map +1 -1
- package/dist/src/components/For.d.ts.map +1 -1
- package/dist/src/components/For.js +1 -1
- package/dist/src/components/For.js.map +1 -1
- package/dist/src/components/List.d.ts +11 -1
- package/dist/src/components/List.d.ts.map +1 -1
- package/dist/src/components/List.js +1 -1
- package/dist/src/components/List.js.map +1 -1
- package/dist/src/components/MemberDeclaration.d.ts +6 -6
- package/dist/src/components/MemberDeclaration.js +6 -6
- package/dist/src/components/MemberName.d.ts +6 -0
- package/dist/src/components/MemberName.d.ts.map +1 -1
- package/dist/src/components/MemberName.js +7 -0
- package/dist/src/components/MemberName.js.map +1 -1
- package/dist/src/components/MemberScope.d.ts +5 -0
- package/dist/src/components/MemberScope.d.ts.map +1 -1
- package/dist/src/components/MemberScope.js +5 -0
- package/dist/src/components/MemberScope.js.map +1 -1
- package/dist/src/components/Output.d.ts +4 -2
- package/dist/src/components/Output.d.ts.map +1 -1
- package/dist/src/components/Output.js.map +1 -1
- package/dist/src/components/Scope.d.ts +6 -0
- package/dist/src/components/Scope.d.ts.map +1 -1
- package/dist/src/components/Scope.js +6 -0
- package/dist/src/components/Scope.js.map +1 -1
- package/dist/src/components/SourceFile.d.ts +22 -2
- package/dist/src/components/SourceFile.d.ts.map +1 -1
- package/dist/src/components/SourceFile.js.map +1 -1
- package/dist/src/components/Switch.d.ts.map +1 -1
- package/dist/src/components/Switch.js +1 -1
- package/dist/src/components/Switch.js.map +1 -1
- package/dist/src/components/index.d.ts +1 -0
- package/dist/src/components/index.d.ts.map +1 -1
- package/dist/src/components/index.js +1 -0
- package/dist/src/components/index.js.map +1 -1
- package/dist/src/context/binder.d.ts +4 -0
- package/dist/src/context/binder.d.ts.map +1 -1
- package/dist/src/context/binder.js +5 -0
- package/dist/src/context/binder.js.map +1 -1
- package/dist/src/context/format-options.d.ts +14 -1
- package/dist/src/context/format-options.d.ts.map +1 -1
- package/dist/src/context/format-options.js +14 -1
- package/dist/src/context/format-options.js.map +1 -1
- package/dist/src/context/scope.d.ts +4 -0
- package/dist/src/context/scope.d.ts.map +1 -1
- package/dist/src/context/scope.js +5 -0
- package/dist/src/context/scope.js.map +1 -1
- package/dist/src/context/source-directory.d.ts +9 -0
- package/dist/src/context/source-directory.d.ts.map +1 -1
- package/dist/src/context/source-directory.js +9 -0
- package/dist/src/context/source-directory.js.map +1 -1
- package/dist/src/debug/cli.d.ts.map +1 -1
- package/dist/src/debug/cli.js +3 -2
- package/dist/src/debug/cli.js.map +1 -1
- package/dist/src/debug/diagnostics-broadcast.test.d.ts +2 -0
- package/dist/src/debug/diagnostics-broadcast.test.d.ts.map +1 -0
- package/dist/src/debug/diagnostics-broadcast.test.js +100 -0
- package/dist/src/debug/diagnostics-broadcast.test.js.map +1 -0
- package/dist/src/debug/diagnostics.test.js +3 -2
- package/dist/src/debug/diagnostics.test.js.map +1 -1
- package/dist/src/debug/effects.d.ts +12 -4
- package/dist/src/debug/effects.d.ts.map +1 -1
- package/dist/src/debug/effects.js +119 -54
- package/dist/src/debug/effects.js.map +1 -1
- package/dist/src/debug/effects.test.js +213 -41
- package/dist/src/debug/effects.test.js.map +1 -1
- package/dist/src/debug/files.d.ts.map +1 -1
- package/dist/src/debug/files.js +7 -18
- package/dist/src/debug/files.js.map +1 -1
- package/dist/src/debug/files.test.js +13 -36
- package/dist/src/debug/files.test.js.map +1 -1
- package/dist/src/debug/index.d.ts +4 -2
- package/dist/src/debug/index.d.ts.map +1 -1
- package/dist/src/debug/index.js +4 -2
- package/dist/src/debug/index.js.map +1 -1
- package/dist/src/debug/message-format.test.d.ts +2 -0
- package/dist/src/debug/message-format.test.d.ts.map +1 -0
- package/dist/src/debug/message-format.test.js +700 -0
- package/dist/src/debug/message-format.test.js.map +1 -0
- package/dist/src/debug/render-tree-orphans.test.d.ts +2 -0
- package/dist/src/debug/render-tree-orphans.test.d.ts.map +1 -0
- package/dist/src/debug/render-tree-orphans.test.js +297 -0
- package/dist/src/debug/render-tree-orphans.test.js.map +1 -0
- package/dist/src/debug/render.d.ts.map +1 -1
- package/dist/src/debug/render.js +91 -131
- package/dist/src/debug/render.js.map +1 -1
- package/dist/src/debug/render.test.js +91 -128
- package/dist/src/debug/render.test.js.map +1 -1
- package/dist/src/debug/source-map.browser.d.ts +16 -0
- package/dist/src/debug/source-map.browser.d.ts.map +1 -0
- package/dist/src/debug/source-map.browser.js +24 -0
- package/dist/src/debug/source-map.browser.js.map +1 -0
- package/dist/src/debug/source-map.d.ts +22 -0
- package/dist/src/debug/source-map.d.ts.map +1 -0
- package/dist/src/debug/source-map.js +111 -0
- package/dist/src/debug/source-map.js.map +1 -0
- package/dist/src/debug/symbols.d.ts +6 -5
- package/dist/src/debug/symbols.d.ts.map +1 -1
- package/dist/src/debug/symbols.js +46 -23
- package/dist/src/debug/symbols.js.map +1 -1
- package/dist/src/debug/symbols.test.js +15 -26
- package/dist/src/debug/symbols.test.js.map +1 -1
- package/dist/src/debug/trace-writer.d.ts +56 -0
- package/dist/src/debug/trace-writer.d.ts.map +1 -0
- package/dist/src/debug/trace-writer.js +674 -0
- package/dist/src/debug/trace-writer.js.map +1 -0
- package/dist/src/debug/trace.d.ts +10 -10
- package/dist/src/debug/trace.d.ts.map +1 -1
- package/dist/src/debug/trace.js +41 -24
- package/dist/src/debug/trace.js.map +1 -1
- package/dist/src/devtools/devtools-protocol.d.ts +318 -161
- package/dist/src/devtools/devtools-protocol.d.ts.map +1 -1
- package/dist/src/devtools/devtools-server.browser.d.ts +1 -5
- package/dist/src/devtools/devtools-server.browser.d.ts.map +1 -1
- package/dist/src/devtools/devtools-server.browser.js +3 -3
- package/dist/src/devtools/devtools-server.browser.js.map +1 -1
- package/dist/src/devtools/devtools-server.d.ts +5 -6
- package/dist/src/devtools/devtools-server.d.ts.map +1 -1
- package/dist/src/devtools/devtools-server.js +227 -25
- package/dist/src/devtools/devtools-server.js.map +1 -1
- package/dist/src/devtools/devtools-transport.d.ts +2 -2
- package/dist/src/devtools/devtools-transport.d.ts.map +1 -1
- package/dist/src/devtools/devtools-transport.js +2 -2
- package/dist/src/devtools/devtools-transport.js.map +1 -1
- package/dist/src/devtools-entry.browser.d.ts +1 -1
- package/dist/src/devtools-entry.browser.d.ts.map +1 -1
- package/dist/src/devtools-entry.browser.js.map +1 -1
- package/dist/src/devtools-entry.d.ts +1 -1
- package/dist/src/devtools-entry.d.ts.map +1 -1
- package/dist/src/devtools-entry.js.map +1 -1
- package/dist/src/diagnostics.d.ts +1 -1
- package/dist/src/diagnostics.d.ts.map +1 -1
- package/dist/src/diagnostics.js +27 -19
- package/dist/src/diagnostics.js.map +1 -1
- package/dist/src/host/node-host.browser.d.ts +11 -0
- package/dist/src/host/node-host.browser.d.ts.map +1 -0
- package/dist/src/host/node-host.browser.js +21 -0
- package/dist/src/host/node-host.browser.js.map +1 -0
- package/dist/src/host/node-host.d.ts +11 -0
- package/dist/src/host/node-host.d.ts.map +1 -0
- package/dist/src/host/node-host.js +20 -0
- package/dist/src/host/node-host.js.map +1 -0
- package/dist/src/library-symbol-reference.d.ts +52 -0
- package/dist/src/library-symbol-reference.d.ts.map +1 -1
- package/dist/src/library-symbol-reference.js +54 -0
- package/dist/src/library-symbol-reference.js.map +1 -1
- package/dist/src/name-policy.d.ts +30 -3
- package/dist/src/name-policy.d.ts.map +1 -1
- package/dist/src/name-policy.js +27 -0
- package/dist/src/name-policy.js.map +1 -1
- package/dist/src/reactivity.d.ts +28 -2
- package/dist/src/reactivity.d.ts.map +1 -1
- package/dist/src/reactivity.js +154 -45
- package/dist/src/reactivity.js.map +1 -1
- package/dist/src/render-stack.d.ts.map +1 -1
- package/dist/src/render-stack.js +4 -3
- package/dist/src/render-stack.js.map +1 -1
- package/dist/src/render.d.ts +2 -0
- package/dist/src/render.d.ts.map +1 -1
- package/dist/src/render.js +84 -30
- package/dist/src/render.js.map +1 -1
- package/dist/src/scheduler.d.ts +5 -0
- package/dist/src/scheduler.d.ts.map +1 -1
- package/dist/src/scheduler.js +94 -23
- package/dist/src/scheduler.js.map +1 -1
- package/dist/src/symbols/output-scope.d.ts +33 -1
- package/dist/src/symbols/output-scope.d.ts.map +1 -1
- package/dist/src/symbols/output-scope.js +34 -1
- package/dist/src/symbols/output-scope.js.map +1 -1
- package/dist/src/symbols/output-space.d.ts +12 -0
- package/dist/src/symbols/output-space.d.ts.map +1 -1
- package/dist/src/symbols/output-space.js +15 -0
- package/dist/src/symbols/output-space.js.map +1 -1
- package/dist/src/symbols/output-symbol.d.ts +128 -12
- package/dist/src/symbols/output-symbol.d.ts.map +1 -1
- package/dist/src/symbols/output-symbol.js +158 -18
- package/dist/src/symbols/output-symbol.js.map +1 -1
- package/dist/src/symbols/symbol-slot.d.ts.map +1 -1
- package/dist/src/symbols/symbol-slot.js +7 -0
- package/dist/src/symbols/symbol-slot.js.map +1 -1
- package/dist/src/symbols/symbol-slot.test.js +18 -1
- package/dist/src/symbols/symbol-slot.test.js.map +1 -1
- package/dist/src/symbols/symbol-table.d.ts.map +1 -1
- package/dist/src/symbols/symbol-table.js +13 -3
- package/dist/src/symbols/symbol-table.js.map +1 -1
- package/dist/src/utils.d.ts.map +1 -1
- package/dist/src/utils.js +11 -5
- package/dist/src/utils.js.map +1 -1
- package/dist/src/write-output.d.ts.map +1 -1
- package/dist/src/write-output.js +6 -5
- package/dist/src/write-output.js.map +1 -1
- package/dist/test/browser-build.test.js +66 -67
- package/dist/test/browser-build.test.js.map +1 -1
- package/dist/test/reactivity/shallow-reactive.test.js +4 -0
- package/dist/test/reactivity/shallow-reactive.test.js.map +1 -1
- package/dist/test/symbols/deconflicted-name.test.d.ts +2 -0
- package/dist/test/symbols/deconflicted-name.test.d.ts.map +1 -0
- package/dist/test/symbols/deconflicted-name.test.js +120 -0
- package/dist/test/symbols/deconflicted-name.test.js.map +1 -0
- package/dist/test/symbols/output-scope.test.js +41 -0
- package/dist/test/symbols/output-scope.test.js.map +1 -1
- package/dist/testing/create-test-wrapper.d.ts +75 -2
- package/dist/testing/create-test-wrapper.d.ts.map +1 -1
- package/dist/testing/create-test-wrapper.js +55 -1
- package/dist/testing/create-test-wrapper.js.map +1 -1
- package/dist/testing/devtools-utils.d.ts +12 -3
- package/dist/testing/devtools-utils.d.ts.map +1 -1
- package/dist/testing/devtools-utils.js +26 -4
- package/dist/testing/devtools-utils.js.map +1 -1
- package/dist/testing/extend-expect.d.ts +26 -0
- package/dist/testing/extend-expect.d.ts.map +1 -1
- package/dist/testing/extend-expect.js +20 -0
- package/dist/testing/extend-expect.js.map +1 -1
- package/dist/testing/index.d.ts +1 -1
- package/dist/testing/index.d.ts.map +1 -1
- package/dist/testing/index.js +1 -1
- package/dist/testing/index.js.map +1 -1
- package/dist/testing/render.d.ts +9 -0
- package/dist/testing/render.d.ts.map +1 -1
- package/dist/testing/render.js +11 -0
- package/dist/testing/render.js.map +1 -1
- package/dist/testing/vitest.d.js +12 -0
- package/dist/testing/vitest.d.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/docs/api/components/AppendRegion.md +83 -0
- package/docs/api/components/Block.md +49 -0
- package/docs/api/components/CopyFile.md +26 -0
- package/docs/api/components/Declaration.md +85 -0
- package/docs/api/components/For.md +91 -0
- package/docs/api/components/Indent.md +40 -0
- package/docs/api/components/List.md +68 -0
- package/docs/api/components/MemberDeclaration.md +89 -0
- package/docs/api/components/MemberName.md +21 -0
- package/docs/api/components/MemberScope.md +81 -0
- package/docs/api/components/Name.md +19 -0
- package/docs/api/components/Output.md +62 -0
- package/docs/api/components/Prose.md +29 -0
- package/docs/api/components/ReferenceOrContent.md +28 -0
- package/docs/api/components/Scope.md +83 -0
- package/docs/api/components/Show.md +32 -0
- package/docs/api/components/SourceDirectory.md +28 -0
- package/docs/api/components/SourceFile.md +60 -0
- package/docs/api/components/StatementList.md +29 -0
- package/docs/api/components/Switch.md +42 -0
- package/docs/api/components/TemplateFile.md +71 -0
- package/docs/api/components/TemplateVariable.md +57 -0
- package/docs/api/components/UpdateFile.md +56 -0
- package/docs/api/components/Wrap.md +40 -0
- package/docs/api/components/createAccessExpression.md +55 -0
- package/docs/api/components/index.md +27 -0
- package/docs/api/contexts/Assignment-context.md +43 -0
- package/docs/api/contexts/Binder-context.md +22 -0
- package/docs/api/contexts/Declaration-context.md +15 -0
- package/docs/api/contexts/Member-context.md +17 -0
- package/docs/api/contexts/MemberDeclaration-context.md +24 -0
- package/docs/api/contexts/NamePolicy-context.md +18 -0
- package/docs/api/contexts/Scope-context.md +20 -0
- package/docs/api/contexts/SourceDirectory-context.md +26 -0
- package/docs/api/contexts/SourceFile-context.md +19 -0
- package/docs/api/contexts/index.md +11 -0
- package/docs/api/functions/attachDiagnosticsCollector.md +18 -0
- package/docs/api/functions/baseListPropsToMapJoinArgs.md +20 -0
- package/docs/api/functions/children.md +27 -0
- package/docs/api/functions/childrenArray.md +25 -0
- package/docs/api/functions/code.md +25 -0
- package/docs/api/functions/computed.md +18 -0
- package/docs/api/functions/createComponent.md +20 -0
- package/docs/api/functions/createContentSlot.md +33 -0
- package/docs/api/functions/createContext.md +19 -0
- package/docs/api/functions/createCustomContext.md +18 -0
- package/docs/api/functions/createDeclarationTap.md +20 -0
- package/docs/api/functions/createFileResource.md +35 -0
- package/docs/api/functions/createFormatOptionsContextFor.md +28 -0
- package/docs/api/functions/createIntrinsic.md +19 -0
- package/docs/api/functions/createMemberTap.md +20 -0
- package/docs/api/functions/createNamePolicy.md +37 -0
- package/docs/api/functions/createNamedContext.md +19 -0
- package/docs/api/functions/createOutputBinder.md +24 -0
- package/docs/api/functions/createRenderTreeHook.md +19 -0
- package/docs/api/functions/createResource.md +77 -0
- package/docs/api/functions/createScope.md +35 -0
- package/docs/api/functions/createScopeTap.md +20 -0
- package/docs/api/functions/createSourceFileTap.md +20 -0
- package/docs/api/functions/createSymbol.md +25 -0
- package/docs/api/functions/createSymbolSlot.md +19 -0
- package/docs/api/functions/createTap.md +55 -0
- package/docs/api/functions/decl.md +20 -0
- package/docs/api/functions/defaultProps.md +21 -0
- package/docs/api/functions/effect.md +26 -0
- package/docs/api/functions/emitDiagnostic.md +18 -0
- package/docs/api/functions/emitSymbol.md +18 -0
- package/docs/api/functions/ensureIsEmpty.md +20 -0
- package/docs/api/functions/findCurrentEffectId.md +19 -0
- package/docs/api/functions/findKeyedChild.md +19 -0
- package/docs/api/functions/findKeyedChildren.md +19 -0
- package/docs/api/functions/findUnkeyedChildren.md +18 -0
- package/docs/api/functions/formatReactivePropertyLabel.md +21 -0
- package/docs/api/functions/getAssignmentSymbol.md +19 -0
- package/docs/api/functions/getContext.md +17 -0
- package/docs/api/functions/getContextForRenderNode.md +18 -0
- package/docs/api/functions/getDiagnosticsForTree.md +18 -0
- package/docs/api/functions/getEffectDebugId.md +18 -0
- package/docs/api/functions/getElementCache.md +17 -0
- package/docs/api/functions/getReactiveCreationLocation.md +18 -0
- package/docs/api/functions/getSymbolCreator.md +18 -0
- package/docs/api/functions/getSymbolCreatorSymbol.md +17 -0
- package/docs/api/functions/index.md +105 -0
- package/docs/api/functions/inspectRefkey.md +18 -0
- package/docs/api/functions/instantiateTakenMembersTo.md +20 -0
- package/docs/api/functions/isComponentCreator.md +19 -0
- package/docs/api/functions/isCustomContext.md +18 -0
- package/docs/api/functions/isIntrinsicElement.md +18 -0
- package/docs/api/functions/isKeyedChild.md +18 -0
- package/docs/api/functions/isLibrarySymbolReference.md +18 -0
- package/docs/api/functions/isMemberRefkey.md +18 -0
- package/docs/api/functions/isNamekey.md +18 -0
- package/docs/api/functions/isPrintHook.md +18 -0
- package/docs/api/functions/isRefkey.md +18 -0
- package/docs/api/functions/isRefkeyable.md +18 -0
- package/docs/api/functions/isRenderableObject.md +20 -0
- package/docs/api/functions/isSymbolRefkey.md +18 -0
- package/docs/api/functions/join.md +33 -0
- package/docs/api/functions/mapJoin.md +106 -0
- package/docs/api/functions/memberRefkey.md +27 -0
- package/docs/api/functions/memo.md +29 -0
- package/docs/api/functions/mergeProps.md +64 -0
- package/docs/api/functions/moveTakenMembersTo.md +18 -0
- package/docs/api/functions/namekey.md +41 -0
- package/docs/api/functions/nextReactiveId.md +19 -0
- package/docs/api/functions/notifyContentState.md +17 -0
- package/docs/api/functions/onCleanup.md +26 -0
- package/docs/api/functions/printTree.md +31 -0
- package/docs/api/functions/reactivePropertyRefId.md +21 -0
- package/docs/api/functions/ref.md +21 -0
- package/docs/api/functions/refId.md +18 -0
- package/docs/api/functions/refkey.md +24 -0
- package/docs/api/functions/render.md +31 -0
- package/docs/api/functions/renderAsync.md +31 -0
- package/docs/api/functions/renderTree.md +18 -0
- package/docs/api/functions/reportDiagnostics.md +18 -0
- package/docs/api/functions/resetRefIdCounter.md +17 -0
- package/docs/api/functions/resolve.md +31 -0
- package/docs/api/functions/root.md +25 -0
- package/docs/api/functions/shallowReactive.md +18 -0
- package/docs/api/functions/shallowRef.md +21 -0
- package/docs/api/functions/sourceFilesForTree.md +31 -0
- package/docs/api/functions/splitProps.md +19 -0
- package/docs/api/functions/stc.md +18 -0
- package/docs/api/functions/sti.md +18 -0
- package/docs/api/functions/symbolForRefkey.md +24 -0
- package/docs/api/functions/taggedComponent.md +19 -0
- package/docs/api/functions/takeSymbols.md +18 -0
- package/docs/api/functions/text.md +19 -0
- package/docs/api/functions/toRef.md +20 -0
- package/docs/api/functions/toRefkey.md +18 -0
- package/docs/api/functions/toRefs.md +20 -0
- package/docs/api/functions/traverseOutput.md +21 -0
- package/docs/api/functions/unresolvedRefkey.md +18 -0
- package/docs/api/functions/untrack.md +18 -0
- package/docs/api/functions/useContext.md +18 -0
- package/docs/api/functions/useFormatOptions.md +18 -0
- package/docs/api/functions/useMemberContext.md +17 -0
- package/docs/api/functions/useMemberScope.md +17 -0
- package/docs/api/functions/writeOutput.md +21 -0
- package/docs/api/index.md +9 -0
- package/docs/api/testing/functions/createTestWrapper.md +70 -0
- package/docs/api/testing/functions/d.md +21 -0
- package/docs/api/testing/functions/dedent.md +18 -0
- package/docs/api/testing/functions/index.md +6 -0
- package/docs/api/testing/functions/renderToString.md +20 -0
- package/docs/api/testing/index.md +4 -0
- package/docs/api/testing/types/TestWrapper.md +10 -0
- package/docs/api/testing/types/ToRenderToOptions.md +24 -0
- package/docs/api/testing/types/index.md +4 -0
- package/docs/api/types/AlignIntrinsicElement.md +5 -0
- package/docs/api/types/AppendRegionProps.md +5 -0
- package/docs/api/types/BaseListProps.md +21 -0
- package/docs/api/types/BasePartProps.md +10 -0
- package/docs/api/types/BasicScope.md +15 -0
- package/docs/api/types/BasicSymbol.md +18 -0
- package/docs/api/types/Binder.md +18 -0
- package/docs/api/types/BinderOptions.md +7 -0
- package/docs/api/types/BrIntrinsicElement.md +5 -0
- package/docs/api/types/BreakParentIntrinsicElement.md +5 -0
- package/docs/api/types/Child.md +5 -0
- package/docs/api/types/Children.md +5 -0
- package/docs/api/types/ChildrenOptions.md +7 -0
- package/docs/api/types/CommonFormatOptions.md +8 -0
- package/docs/api/types/Component.md +8 -0
- package/docs/api/types/ComponentContext.md +11 -0
- package/docs/api/types/ComponentCreator.md +11 -0
- package/docs/api/types/ComponentDefinition.md +7 -0
- package/docs/api/types/ContentOutputFile.md +10 -0
- package/docs/api/types/ContentSlot.md +12 -0
- package/docs/api/types/Context.md +19 -0
- package/docs/api/types/ContextProviderProps.md +8 -0
- package/docs/api/types/CopyFileContext.md +8 -0
- package/docs/api/types/CopyOutputFile.md +9 -0
- package/docs/api/types/CustomContext.md +10 -0
- package/docs/api/types/CustomContextChildrenCallback.md +5 -0
- package/docs/api/types/DeclarationProps.md +5 -0
- package/docs/api/types/DedentIntrinsicElement.md +5 -0
- package/docs/api/types/DedentToRootIntrinsicElement.md +5 -0
- package/docs/api/types/Diagnostic.md +11 -0
- package/docs/api/types/DiagnosticHandle.md +7 -0
- package/docs/api/types/DiagnosticInput.md +10 -0
- package/docs/api/types/DiagnosticSeverity.md +5 -0
- package/docs/api/types/DiagnosticStackEntry.md +9 -0
- package/docs/api/types/DiagnosticsCollector.md +8 -0
- package/docs/api/types/Disposable_2.md +7 -0
- package/docs/api/types/EffectDebugOptions.md +8 -0
- package/docs/api/types/EffectOptions.md +7 -0
- package/docs/api/types/ElementCache.md +5 -0
- package/docs/api/types/ElementCacheKey.md +5 -0
- package/docs/api/types/FillIntrinsicElement.md +5 -0
- package/docs/api/types/ForCallbackArgs.md +5 -0
- package/docs/api/types/ForSupportedCollections.md +5 -0
- package/docs/api/types/GroupIntrinsicElement.md +5 -0
- package/docs/api/types/HardlineIntrinsicElement.md +5 -0
- package/docs/api/types/HbrIntrinsicElement.md +5 -0
- package/docs/api/types/IfBreakIntrinsicElement.md +5 -0
- package/docs/api/types/IndentIfBreakIntrinsicElement.md +5 -0
- package/docs/api/types/IndentIntrinsicElement.md +5 -0
- package/docs/api/types/IntrinsicElement.md +5 -0
- package/docs/api/types/IntrinsicElementBase.md +9 -0
- package/docs/api/types/IntrinsicElements.md +26 -0
- package/docs/api/types/JoinOptions.md +9 -0
- package/docs/api/types/LbrIntrinsicElement.md +5 -0
- package/docs/api/types/LibrarySymbolReference.md +13 -0
- package/docs/api/types/LineIntrinsicElement.md +5 -0
- package/docs/api/types/LineSuffixBoundaryIntrinsicElement.md +5 -0
- package/docs/api/types/LineSuffixIntrinsicElement.md +5 -0
- package/docs/api/types/LiterallineIntrinsicElement.md +5 -0
- package/docs/api/types/MakeChildrenOptional.md +7 -0
- package/docs/api/types/MarkAsRootIntrinsicElement.md +5 -0
- package/docs/api/types/MatchProps.md +9 -0
- package/docs/api/types/MemberDeclarationProps.md +5 -0
- package/docs/api/types/MemberDescriptor.md +10 -0
- package/docs/api/types/MemberRefkey.md +10 -0
- package/docs/api/types/MemberResolutionContext.md +10 -0
- package/docs/api/types/MemberResolver.md +32 -0
- package/docs/api/types/MemberScopeProps.md +5 -0
- package/docs/api/types/Metadata.md +5 -0
- package/docs/api/types/NameConflictResolver.md +27 -0
- package/docs/api/types/NamePolicy.md +8 -0
- package/docs/api/types/NamePolicyGetter.md +9 -0
- package/docs/api/types/Namekey.md +10 -0
- package/docs/api/types/NamekeyOptions.md +8 -0
- package/docs/api/types/OnReactiveSetAddCallback.md +5 -0
- package/docs/api/types/OnReactiveSetDeleteCallback.md +5 -0
- package/docs/api/types/OutputDeclarationSpace.md +13 -0
- package/docs/api/types/OutputDirectory.md +59 -0
- package/docs/api/types/OutputFile.md +5 -0
- package/docs/api/types/OutputFileBase.md +8 -0
- package/docs/api/types/OutputMemberSpace.md +13 -0
- package/docs/api/types/OutputScope.md +33 -0
- package/docs/api/types/OutputScopeOptions.md +9 -0
- package/docs/api/types/OutputSpace.md +7 -0
- package/docs/api/types/OutputSymbol.md +78 -0
- package/docs/api/types/OutputSymbolOptions.md +16 -0
- package/docs/api/types/OutputVisitor.md +10 -0
- package/docs/api/types/PrintHook.md +10 -0
- package/docs/api/types/PrintTreeOptions.md +11 -0
- package/docs/api/types/Props.md +5 -0
- package/docs/api/types/ReactiveUnionSet.md +20 -0
- package/docs/api/types/ReactiveUnionSetOptions.md +8 -0
- package/docs/api/types/Refkey.md +5 -0
- package/docs/api/types/Refkeyable.md +5 -0
- package/docs/api/types/RefkeyableObject.md +7 -0
- package/docs/api/types/RenderableObject.md +9 -0
- package/docs/api/types/RenderedTextTree.md +5 -0
- package/docs/api/types/ResolutionResult.md +39 -0
- package/docs/api/types/ResolveDeclarationByKeyOptions.md +7 -0
- package/docs/api/types/Resource.md +11 -0
- package/docs/api/types/RootOptions.md +7 -0
- package/docs/api/types/SbrIntrinsicElement.md +5 -0
- package/docs/api/types/ScopeProps.md +5 -0
- package/docs/api/types/SoftlineIntrinsicElement.md +5 -0
- package/docs/api/types/SourceLocation.md +9 -0
- package/docs/api/types/SplitProps.md +12 -0
- package/docs/api/types/StcComponentCreator.md +9 -0
- package/docs/api/types/StcSignature.md +5 -0
- package/docs/api/types/StiComponentCreator.md +9 -0
- package/docs/api/types/StiSignature.md +7 -0
- package/docs/api/types/SymbolCreator.md +15 -0
- package/docs/api/types/SymbolRefkey.md +9 -0
- package/docs/api/types/SymbolSlot.md +12 -0
- package/docs/api/types/SymbolTable.md +15 -0
- package/docs/api/types/TakeSymbolCallback.md +7 -0
- package/docs/api/types/TakeSymbolsCallback.md +7 -0
- package/docs/api/types/Tap.md +11 -0
- package/docs/api/types/TapHandler.md +9 -0
- package/docs/api/types/Tapper.md +9 -0
- package/docs/api/types/TemplateVariableProps.md +5 -0
- package/docs/api/types/index.md +122 -0
- package/docs/api/variables/FormatOptions.md +5 -0
- package/docs/api/variables/Match.md +7 -0
- package/docs/api/variables/REFKEYABLE.md +5 -0
- package/docs/api/variables/RENDERABLE.md +5 -0
- package/docs/api/variables/TO_SYMBOL.md +39 -0
- package/docs/api/variables/contextsByKey.md +5 -0
- package/docs/api/variables/index.md +11 -0
- package/docs/api/variables/intrinsicElementKey.md +5 -0
- package/docs/api/variables/matchTag.md +5 -0
- package/docs/api/variables/printHookTag.md +7 -0
- package/docs/components.md +97 -0
- package/docs/context.md +67 -0
- package/docs/control-flow.md +5 -0
- package/docs/debugging.md +105 -0
- package/docs/formatting.md +99 -0
- package/docs/guides/language-package-guide.md +593 -0
- package/docs/guides/references-and-refkeys.md +210 -0
- package/docs/guides/style-guide.md +244 -0
- package/docs/index.md +22 -0
- package/docs/reactivity.md +68 -0
- package/docs/rendering.md +41 -0
- package/docs/symbols-and-scopes.md +180 -0
- package/package.json +16 -6
- package/src/binder.ts +154 -41
- package/src/components/AccessExpression.test.tsx +132 -0
- package/src/components/AccessExpression.tsx +344 -0
- package/src/components/Block.tsx +12 -0
- package/src/components/For.tsx +14 -10
- package/src/components/List.tsx +18 -5
- package/src/components/MemberDeclaration.tsx +6 -6
- package/src/components/MemberName.tsx +6 -0
- package/src/components/MemberScope.tsx +5 -0
- package/src/components/Output.tsx +4 -1
- package/src/components/Scope.tsx +6 -0
- package/src/components/SourceFile.tsx +22 -2
- package/src/components/Switch.tsx +11 -7
- package/src/components/index.tsx +1 -0
- package/src/context/binder.ts +4 -0
- package/src/context/format-options.ts +14 -1
- package/src/context/scope.ts +4 -0
- package/src/context/source-directory.ts +9 -0
- package/src/debug/cli.ts +3 -2
- package/src/debug/diagnostics-broadcast.test.tsx +98 -0
- package/src/debug/diagnostics.test.tsx +3 -2
- package/src/debug/effects.test.tsx +248 -36
- package/src/debug/effects.ts +198 -64
- package/src/debug/files.test.tsx +15 -35
- package/src/debug/files.ts +11 -11
- package/src/debug/index.ts +4 -0
- package/src/debug/message-format.test.tsx +759 -0
- package/src/debug/render-tree-orphans.test.tsx +344 -0
- package/src/debug/render.test.tsx +96 -118
- package/src/debug/render.ts +196 -125
- package/src/debug/source-map.browser.ts +30 -0
- package/src/debug/source-map.ts +135 -0
- package/src/debug/symbols.test.tsx +19 -20
- package/src/debug/symbols.ts +106 -23
- package/src/debug/trace-writer.ts +984 -0
- package/src/debug/trace.ts +46 -32
- package/src/devtools/devtools-protocol.ts +361 -176
- package/src/devtools/devtools-server.browser.ts +4 -9
- package/src/devtools/devtools-server.ts +226 -33
- package/src/devtools/devtools-transport.ts +4 -4
- package/src/devtools-entry.browser.ts +11 -15
- package/src/devtools-entry.ts +9 -15
- package/src/diagnostics.ts +44 -22
- package/src/host/node-host.browser.ts +23 -0
- package/src/host/node-host.ts +22 -0
- package/src/library-symbol-reference.ts +52 -0
- package/src/name-policy.ts +30 -3
- package/src/reactivity.ts +179 -55
- package/src/render-stack.ts +4 -3
- package/src/render.ts +106 -30
- package/src/scheduler.ts +145 -26
- package/src/symbols/output-scope.ts +33 -1
- package/src/symbols/output-space.ts +13 -0
- package/src/symbols/output-symbol.ts +185 -22
- package/src/symbols/symbol-slot.test.tsx +28 -1
- package/src/symbols/symbol-slot.tsx +8 -0
- package/src/symbols/symbol-table.ts +13 -3
- package/src/utils.tsx +7 -4
- package/src/write-output.ts +6 -5
- package/temp/api-testing.json +673 -0
- package/temp/api.json +895 -73
- package/test/browser-build.test.ts +71 -78
- package/test/reactivity/shallow-reactive.test.tsx +4 -0
- package/test/symbols/deconflicted-name.test.ts +120 -0
- package/test/symbols/output-scope.test.ts +38 -0
- package/testing/create-test-wrapper.tsx +81 -2
- package/testing/devtools-utils.ts +46 -4
- package/testing/extend-expect.ts +22 -1
- package/testing/index.ts +1 -1
- package/testing/render.ts +9 -0
- package/testing/vitest.d.ts +18 -3
- package/vitest.config.ts +8 -0
|
@@ -0,0 +1,458 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Devtools session manager.
|
|
3
|
+
*
|
|
4
|
+
* Manages the lifecycle of a devtools session: enable, connect, broadcast
|
|
5
|
+
* messages, and reset. Transport details (HTTP/WebSocket) are delegated
|
|
6
|
+
* to devtools-transport.ts.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import { ALL_CHANNELS, closeTrace, initTrace, isTraceEnabled, queryChannel, setChangeListener } from "../debug/trace-writer.js";
|
|
10
|
+
import { createTransport, getAlloyVersion } from "./devtools-transport.js";
|
|
11
|
+
|
|
12
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
13
|
+
// Public types
|
|
14
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
15
|
+
|
|
16
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
17
|
+
// Session state
|
|
18
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
19
|
+
|
|
20
|
+
let transportState = null;
|
|
21
|
+
let transportPromise = null;
|
|
22
|
+
const messageHandlers = new Set();
|
|
23
|
+
let devtoolsExplicitlyEnabled = false;
|
|
24
|
+
let devtoolsInitialized = false;
|
|
25
|
+
let loggedDevtoolsLinks = false;
|
|
26
|
+
let waitingForConnection = false;
|
|
27
|
+
let configuredPort;
|
|
28
|
+
let tempDbPath = null;
|
|
29
|
+
let subscribedPromise = null;
|
|
30
|
+
let resolveSubscribed = null;
|
|
31
|
+
|
|
32
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
33
|
+
// Per-client subscription state
|
|
34
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
35
|
+
|
|
36
|
+
const clientStates = new Map();
|
|
37
|
+
function eventToMessageType(event) {
|
|
38
|
+
const map = {
|
|
39
|
+
render: {
|
|
40
|
+
added: "render:node_added",
|
|
41
|
+
updated: "render:node_updated",
|
|
42
|
+
removed: "render:node_removed",
|
|
43
|
+
reset: "render:reset"
|
|
44
|
+
},
|
|
45
|
+
effects: {
|
|
46
|
+
added: "effect:added",
|
|
47
|
+
updated: "effect:updated"
|
|
48
|
+
},
|
|
49
|
+
refs: {
|
|
50
|
+
added: "ref:added"
|
|
51
|
+
},
|
|
52
|
+
edges: {
|
|
53
|
+
added: `edge:${event.data.edge_type ?? "track"}`
|
|
54
|
+
},
|
|
55
|
+
symbols: {
|
|
56
|
+
added: "symbol:added",
|
|
57
|
+
updated: "symbol:updated",
|
|
58
|
+
removed: "symbol:removed"
|
|
59
|
+
},
|
|
60
|
+
scopes: {
|
|
61
|
+
added: "scope:added",
|
|
62
|
+
updated: "scope:updated",
|
|
63
|
+
removed: "scope:removed"
|
|
64
|
+
},
|
|
65
|
+
files: {
|
|
66
|
+
added: "file:added",
|
|
67
|
+
updated: "file:updated",
|
|
68
|
+
removed: "file:removed"
|
|
69
|
+
},
|
|
70
|
+
directories: {
|
|
71
|
+
added: "directory:added",
|
|
72
|
+
removed: "directory:removed"
|
|
73
|
+
},
|
|
74
|
+
diagnostics: {
|
|
75
|
+
added: "diagnostics:report"
|
|
76
|
+
},
|
|
77
|
+
errors: {
|
|
78
|
+
added: "render:error"
|
|
79
|
+
},
|
|
80
|
+
lifecycle: {
|
|
81
|
+
added: "effect:lifecycle"
|
|
82
|
+
},
|
|
83
|
+
scheduler: {
|
|
84
|
+
added: "scheduler:job"
|
|
85
|
+
}
|
|
86
|
+
};
|
|
87
|
+
return map[event.channel]?.[event.action] ?? `${event.channel}:${event.action}`;
|
|
88
|
+
}
|
|
89
|
+
function channelToInitialMessageType(channel, row) {
|
|
90
|
+
const map = {
|
|
91
|
+
render: "render:node_added",
|
|
92
|
+
effects: "effect:added",
|
|
93
|
+
refs: "ref:added",
|
|
94
|
+
symbols: "symbol:added",
|
|
95
|
+
scopes: "scope:added",
|
|
96
|
+
files: "file:added",
|
|
97
|
+
directories: "directory:added",
|
|
98
|
+
diagnostics: "diagnostics:report",
|
|
99
|
+
errors: "render:error",
|
|
100
|
+
lifecycle: "effect:lifecycle",
|
|
101
|
+
scheduler: "scheduler:job"
|
|
102
|
+
};
|
|
103
|
+
if (channel === "edges") {
|
|
104
|
+
return `edge:${row.type ?? "track"}`;
|
|
105
|
+
}
|
|
106
|
+
return map[channel] ?? `${channel}:added`;
|
|
107
|
+
}
|
|
108
|
+
function sendInitialState(socket, channels) {
|
|
109
|
+
if (!isTraceEnabled()) return;
|
|
110
|
+
for (const channel of channels) {
|
|
111
|
+
const rows = queryChannel(channel);
|
|
112
|
+
for (const row of rows) {
|
|
113
|
+
const msgType = channelToInitialMessageType(channel, row);
|
|
114
|
+
// Remap SQLite column names that collide with the message `type` field
|
|
115
|
+
if (channel === "effects" && row.type !== undefined) {
|
|
116
|
+
row.effect_type = row.type;
|
|
117
|
+
}
|
|
118
|
+
const msg = {
|
|
119
|
+
...row,
|
|
120
|
+
type: msgType
|
|
121
|
+
};
|
|
122
|
+
socket.send(JSON.stringify(msg));
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
128
|
+
// Environment helpers
|
|
129
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
130
|
+
|
|
131
|
+
function isNodeEnvironment() {
|
|
132
|
+
return typeof process !== "undefined" && typeof process.versions === "object" && Boolean(process.versions?.node);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
// Cached once at module load. Stable for production runs. Tests that modify
|
|
136
|
+
// process.env.ALLOY_DEBUG dynamically must call refreshDebugState() afterward.
|
|
137
|
+
let _envDebugEnabled = isNodeEnvironment() && Boolean(process.env.ALLOY_DEBUG);
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Invalidates the cached env-var result for isDevtoolsEnabled(). Call this in
|
|
141
|
+
* test beforeEach hooks after modifying process.env.ALLOY_DEBUG.
|
|
142
|
+
*/
|
|
143
|
+
export function refreshDebugState() {
|
|
144
|
+
_envDebugEnabled = isNodeEnvironment() && Boolean(process.env.ALLOY_DEBUG);
|
|
145
|
+
}
|
|
146
|
+
function getCwd() {
|
|
147
|
+
if (!isNodeEnvironment()) return undefined;
|
|
148
|
+
try {
|
|
149
|
+
return process.cwd();
|
|
150
|
+
} catch {
|
|
151
|
+
return undefined;
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
function resolveDebugPort() {
|
|
155
|
+
const raw = process.env.ALLOY_DEBUG_PORT;
|
|
156
|
+
if (!raw) return 8123;
|
|
157
|
+
const parsed = Number.parseInt(raw, 10);
|
|
158
|
+
if (Number.isNaN(parsed)) return 8123;
|
|
159
|
+
return parsed;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
163
|
+
// Query functions
|
|
164
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
165
|
+
|
|
166
|
+
/** Returns true when devtools are enabled (via env var or explicit call). */
|
|
167
|
+
export function isDevtoolsEnabled() {
|
|
168
|
+
if (!isNodeEnvironment()) return false;
|
|
169
|
+
return devtoolsExplicitlyEnabled || _envDebugEnabled;
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** Returns true when a devtools client is currently connected. */
|
|
173
|
+
export function isDevtoolsConnected() {
|
|
174
|
+
return Boolean(transportState?.connected);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/** Get the current server info, or null if not running. */
|
|
178
|
+
export function getDevtoolsServerInfo() {
|
|
179
|
+
if (!transportState) return null;
|
|
180
|
+
return {
|
|
181
|
+
port: transportState.port,
|
|
182
|
+
connected: transportState.connected
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
187
|
+
// Temp SQLite for devtools
|
|
188
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
189
|
+
|
|
190
|
+
async function ensureSqliteForDevtools() {
|
|
191
|
+
if (isTraceEnabled()) return;
|
|
192
|
+
const os = await import("node:os");
|
|
193
|
+
const path = await import("node:path");
|
|
194
|
+
tempDbPath = path.join(os.tmpdir(), `alloy-debug-${process.pid}.db`);
|
|
195
|
+
await initTrace(tempDbPath);
|
|
196
|
+
process.on("exit", () => {
|
|
197
|
+
if (!tempDbPath) return;
|
|
198
|
+
try {
|
|
199
|
+
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
200
|
+
const fs = require("node:fs");
|
|
201
|
+
fs.unlinkSync(tempDbPath);
|
|
202
|
+
try {
|
|
203
|
+
fs.unlinkSync(tempDbPath + "-wal");
|
|
204
|
+
} catch {
|
|
205
|
+
/* ignore */
|
|
206
|
+
}
|
|
207
|
+
try {
|
|
208
|
+
fs.unlinkSync(tempDbPath + "-shm");
|
|
209
|
+
} catch {
|
|
210
|
+
/* ignore */
|
|
211
|
+
}
|
|
212
|
+
} catch {
|
|
213
|
+
/* ignore cleanup failures */
|
|
214
|
+
}
|
|
215
|
+
});
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
219
|
+
// Server lifecycle
|
|
220
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
221
|
+
|
|
222
|
+
async function ensureServer() {
|
|
223
|
+
if (transportState) return transportState;
|
|
224
|
+
if (!transportPromise) {
|
|
225
|
+
transportPromise = createTransport({
|
|
226
|
+
port: configuredPort ?? resolveDebugPort(),
|
|
227
|
+
onConnection(socket) {
|
|
228
|
+
// Start with no subscriptions — client must subscribe explicitly.
|
|
229
|
+
clientStates.set(socket, {
|
|
230
|
+
subscriptions: new Set()
|
|
231
|
+
});
|
|
232
|
+
if (!subscribedPromise) {
|
|
233
|
+
subscribedPromise = new Promise(resolve => {
|
|
234
|
+
resolveSubscribed = resolve;
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
if (waitingForConnection) {
|
|
238
|
+
waitingForConnection = false;
|
|
239
|
+
process.stdout.write(" Connected!\n");
|
|
240
|
+
}
|
|
241
|
+
socket.send(JSON.stringify({
|
|
242
|
+
type: "debugger:info",
|
|
243
|
+
version: getAlloyVersion(),
|
|
244
|
+
cwd: getCwd(),
|
|
245
|
+
sourceMapEnabled: process.execArgv.includes("--enable-source-maps")
|
|
246
|
+
}));
|
|
247
|
+
},
|
|
248
|
+
onMessage(raw, socket) {
|
|
249
|
+
const message = raw;
|
|
250
|
+
if (!message || !message.type) return;
|
|
251
|
+
if (message.type === "subscribe") {
|
|
252
|
+
const channels = message.channels;
|
|
253
|
+
const state = clientStates.get(socket);
|
|
254
|
+
if (state && channels && Array.isArray(channels)) {
|
|
255
|
+
const validChannels = channels.filter(ch => ALL_CHANNELS.includes(ch));
|
|
256
|
+
state.subscriptions = new Set(validChannels);
|
|
257
|
+
sendInitialState(socket, validChannels);
|
|
258
|
+
}
|
|
259
|
+
resolveSubscribed?.();
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
262
|
+
if (message.type === "unsubscribe") {
|
|
263
|
+
const channels = message.channels;
|
|
264
|
+
const state = clientStates.get(socket);
|
|
265
|
+
if (state && channels) {
|
|
266
|
+
for (const ch of channels) state.subscriptions.delete(ch);
|
|
267
|
+
}
|
|
268
|
+
return;
|
|
269
|
+
}
|
|
270
|
+
for (const handler of messageHandlers) {
|
|
271
|
+
handler(message);
|
|
272
|
+
}
|
|
273
|
+
},
|
|
274
|
+
onDisconnect(socket) {
|
|
275
|
+
clientStates.delete(socket);
|
|
276
|
+
}
|
|
277
|
+
}).then(state => {
|
|
278
|
+
transportState = state;
|
|
279
|
+
|
|
280
|
+
// Wire up the change notification bus to forward events to subscribed clients
|
|
281
|
+
setChangeListener(event => {
|
|
282
|
+
if (!transportState) return;
|
|
283
|
+
|
|
284
|
+
// Lifecycle signals are broadcast to ALL connected clients
|
|
285
|
+
const signalType = event.data?._signal;
|
|
286
|
+
if (signalType) {
|
|
287
|
+
const payload = JSON.stringify({
|
|
288
|
+
type: signalType
|
|
289
|
+
});
|
|
290
|
+
for (const client of transportState.clients) {
|
|
291
|
+
if (client.readyState === client.OPEN) {
|
|
292
|
+
client.send(payload);
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
return;
|
|
296
|
+
}
|
|
297
|
+
const msgType = eventToMessageType(event);
|
|
298
|
+
const message = {
|
|
299
|
+
...event.data,
|
|
300
|
+
type: msgType
|
|
301
|
+
};
|
|
302
|
+
const payload = JSON.stringify(message);
|
|
303
|
+
for (const [client, clientState] of clientStates) {
|
|
304
|
+
if (client.readyState !== client.OPEN) continue;
|
|
305
|
+
if (clientState.subscriptions.has(event.channel)) {
|
|
306
|
+
client.send(payload);
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
});
|
|
310
|
+
if (!loggedDevtoolsLinks) {
|
|
311
|
+
loggedDevtoolsLinks = true;
|
|
312
|
+
// eslint-disable-next-line no-console
|
|
313
|
+
console.log(`Alloy ${getAlloyVersion()}`);
|
|
314
|
+
// eslint-disable-next-line no-console
|
|
315
|
+
console.log(`➜ Debug UI: http://localhost:${state.port}/`);
|
|
316
|
+
// eslint-disable-next-line no-console
|
|
317
|
+
console.log(`➜ Websocket: ws://localhost:${state.port}/`);
|
|
318
|
+
// eslint-disable-next-line no-console
|
|
319
|
+
console.log("");
|
|
320
|
+
waitingForConnection = true;
|
|
321
|
+
process.stdout.write("Waiting for connection...");
|
|
322
|
+
}
|
|
323
|
+
return state;
|
|
324
|
+
});
|
|
325
|
+
}
|
|
326
|
+
return transportPromise;
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
330
|
+
// Public API
|
|
331
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* Wait for a devtools client to connect before proceeding.
|
|
335
|
+
*
|
|
336
|
+
* Starts the devtools server if not already running, and blocks until a
|
|
337
|
+
* devtools client connects via WebSocket.
|
|
338
|
+
*
|
|
339
|
+
* @example
|
|
340
|
+
* ```ts
|
|
341
|
+
* import { waitForDevtoolsConnection } from "@alloy-js/core/devtools";
|
|
342
|
+
* import { render } from "@alloy-js/core";
|
|
343
|
+
*
|
|
344
|
+
* await waitForDevtoolsConnection();
|
|
345
|
+
* const tree = render(<MyComponent />);
|
|
346
|
+
* ```
|
|
347
|
+
*/
|
|
348
|
+
export async function waitForDevtoolsConnection() {
|
|
349
|
+
devtoolsExplicitlyEnabled = true;
|
|
350
|
+
const server = await ensureServer();
|
|
351
|
+
if (!server.connected) {
|
|
352
|
+
await server.ready;
|
|
353
|
+
}
|
|
354
|
+
// Wait for the client to send its initial subscribe message so that
|
|
355
|
+
// messages emitted during a synchronous render are not dropped.
|
|
356
|
+
if (subscribedPromise) {
|
|
357
|
+
await subscribedPromise;
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
/**
|
|
362
|
+
* Enable devtools and start the server, returning when the server is ready.
|
|
363
|
+
* Use this in tests to enable devtools before connecting a client.
|
|
364
|
+
*
|
|
365
|
+
* @returns Server info with port number
|
|
366
|
+
*/
|
|
367
|
+
export async function enableDevtools(options) {
|
|
368
|
+
devtoolsExplicitlyEnabled = true;
|
|
369
|
+
devtoolsInitialized = true;
|
|
370
|
+
if (options?.port !== undefined) {
|
|
371
|
+
configuredPort = options.port;
|
|
372
|
+
}
|
|
373
|
+
await ensureSqliteForDevtools();
|
|
374
|
+
const server = await ensureServer();
|
|
375
|
+
return {
|
|
376
|
+
port: server.port,
|
|
377
|
+
connected: server.connected
|
|
378
|
+
};
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
/**
|
|
382
|
+
* Initialize devtools if ALLOY_DEBUG is set. Called lazily by render functions.
|
|
383
|
+
* Returns immediately if devtools are not enabled or already initialized.
|
|
384
|
+
*/
|
|
385
|
+
export async function initDevtoolsIfEnabled() {
|
|
386
|
+
if (devtoolsInitialized) return;
|
|
387
|
+
if (!isDevtoolsEnabled()) return;
|
|
388
|
+
devtoolsInitialized = true;
|
|
389
|
+
await ensureSqliteForDevtools();
|
|
390
|
+
await waitForDevtoolsConnection();
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
/**
|
|
394
|
+
* Start the devtools server and wait for a client connection.
|
|
395
|
+
*
|
|
396
|
+
* @example
|
|
397
|
+
* ```ts
|
|
398
|
+
* const serverInfo = await enableDevtoolsAndConnect({ port: 0 });
|
|
399
|
+
* // ... run your test ...
|
|
400
|
+
* await resetDevtoolsServerForTests();
|
|
401
|
+
* ```
|
|
402
|
+
*
|
|
403
|
+
* @returns Server info once a client has connected
|
|
404
|
+
*/
|
|
405
|
+
export async function enableDevtoolsAndConnect(options) {
|
|
406
|
+
const info = await enableDevtools(options);
|
|
407
|
+
if (!info.connected) {
|
|
408
|
+
await transportState.ready;
|
|
409
|
+
}
|
|
410
|
+
return {
|
|
411
|
+
port: transportState.port,
|
|
412
|
+
connected: true
|
|
413
|
+
};
|
|
414
|
+
}
|
|
415
|
+
|
|
416
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
417
|
+
// Messaging
|
|
418
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
419
|
+
|
|
420
|
+
/** Register a handler for incoming devtools messages. Returns an unsubscribe function. */
|
|
421
|
+
export function registerDevtoolsMessageHandler(handler) {
|
|
422
|
+
messageHandlers.add(handler);
|
|
423
|
+
return () => messageHandlers.delete(handler);
|
|
424
|
+
}
|
|
425
|
+
|
|
426
|
+
/** Throw if devtools are enabled but no client is connected (for sync render). */
|
|
427
|
+
export function assertDevtoolsConnectedForSyncRender() {
|
|
428
|
+
if (!isDevtoolsEnabled()) return;
|
|
429
|
+
if (!transportState || !transportState.connected) {
|
|
430
|
+
throw new Error("ALLOY_DEBUG is set but devtools are not connected. Use renderAsync or wait for the devtools client before rendering.");
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
|
|
434
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
435
|
+
// Test utilities
|
|
436
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
437
|
+
|
|
438
|
+
/** Reset all devtools state. For use in tests only. */
|
|
439
|
+
export async function resetDevtoolsServerForTests() {
|
|
440
|
+
setChangeListener(null);
|
|
441
|
+
clientStates.clear();
|
|
442
|
+
if (transportState) {
|
|
443
|
+
await transportState.close();
|
|
444
|
+
}
|
|
445
|
+
transportState = null;
|
|
446
|
+
transportPromise = null;
|
|
447
|
+
devtoolsExplicitlyEnabled = false;
|
|
448
|
+
devtoolsInitialized = false;
|
|
449
|
+
configuredPort = undefined;
|
|
450
|
+
loggedDevtoolsLinks = false;
|
|
451
|
+
subscribedPromise = null;
|
|
452
|
+
resolveSubscribed = null;
|
|
453
|
+
// Re-read the env var in case tests modified process.env.ALLOY_DEBUG
|
|
454
|
+
refreshDebugState();
|
|
455
|
+
// Close the trace DB so each test starts fresh
|
|
456
|
+
closeTrace();
|
|
457
|
+
}
|
|
458
|
+
//# sourceMappingURL=devtools-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["ALL_CHANNELS","closeTrace","initTrace","isTraceEnabled","queryChannel","setChangeListener","createTransport","getAlloyVersion","transportState","transportPromise","messageHandlers","Set","devtoolsExplicitlyEnabled","devtoolsInitialized","loggedDevtoolsLinks","waitingForConnection","configuredPort","tempDbPath","subscribedPromise","resolveSubscribed","clientStates","Map","eventToMessageType","event","map","render","added","updated","removed","reset","effects","refs","edges","data","edge_type","symbols","scopes","files","directories","diagnostics","errors","lifecycle","scheduler","channel","action","channelToInitialMessageType","row","type","sendInitialState","socket","channels","rows","msgType","undefined","effect_type","msg","send","JSON","stringify","isNodeEnvironment","process","versions","Boolean","node","_envDebugEnabled","env","ALLOY_DEBUG","refreshDebugState","getCwd","cwd","resolveDebugPort","raw","ALLOY_DEBUG_PORT","parsed","Number","parseInt","isNaN","isDevtoolsEnabled","isDevtoolsConnected","connected","getDevtoolsServerInfo","port","ensureSqliteForDevtools","os","path","join","tmpdir","pid","on","fs","require","unlinkSync","ensureServer","onConnection","set","subscriptions","Promise","resolve","stdout","write","version","sourceMapEnabled","execArgv","includes","onMessage","message","state","get","Array","isArray","validChannels","filter","ch","delete","handler","onDisconnect","then","signalType","_signal","payload","client","clients","readyState","OPEN","clientState","has","console","log","waitForDevtoolsConnection","server","ready","enableDevtools","options","initDevtoolsIfEnabled","enableDevtoolsAndConnect","info","registerDevtoolsMessageHandler","add","assertDevtoolsConnectedForSyncRender","Error","resetDevtoolsServerForTests","clear","close"],"sources":["../../../../src/devtools/devtools-server.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* WebSocket transport for the Alloy devtools server.
|
|
3
|
+
*
|
|
4
|
+
* Handles HTTP serving of the devtools UI and WebSocket connection management.
|
|
5
|
+
* This module is concerned only with the transport layer — session lifecycle
|
|
6
|
+
* is managed by devtools-server.ts.
|
|
7
|
+
*/
|
|
8
|
+
import { readFileSync } from "node:fs";
|
|
9
|
+
import { createServer as createHttpServer } from "node:http";
|
|
10
|
+
let cachedAlloyVersion = null;
|
|
11
|
+
|
|
12
|
+
/** Read the @alloy-js/core package version, cached after first call. */
|
|
13
|
+
export function getAlloyVersion() {
|
|
14
|
+
if (cachedAlloyVersion) return cachedAlloyVersion;
|
|
15
|
+
try {
|
|
16
|
+
const pkgUrl = new URL("../../../package.json", import.meta.url);
|
|
17
|
+
const pkg = JSON.parse(readFileSync(pkgUrl, "utf-8"));
|
|
18
|
+
cachedAlloyVersion = pkg.version ?? "0.0.0";
|
|
19
|
+
} catch {
|
|
20
|
+
cachedAlloyVersion = "0.0.0";
|
|
21
|
+
}
|
|
22
|
+
return cachedAlloyVersion;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Attempt to load the devtools UI HTML from known candidate paths. */
|
|
26
|
+
function loadDevtoolsUiHtml() {
|
|
27
|
+
const candidates = [new URL("../../dist/devtools/index.html", import.meta.url), new URL("../../devtools/index.html", import.meta.url), new URL("../../../devtools/dist/index.html", import.meta.url)];
|
|
28
|
+
for (const candidate of candidates) {
|
|
29
|
+
try {
|
|
30
|
+
return readFileSync(candidate, "utf-8");
|
|
31
|
+
} catch {
|
|
32
|
+
// try next
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
return null;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Create the HTTP + WebSocket transport. Returns when the server is listening.
|
|
39
|
+
* Only accepts one concurrent WebSocket connection.
|
|
40
|
+
*/
|
|
41
|
+
export async function createTransport(options) {
|
|
42
|
+
const {
|
|
43
|
+
WebSocketServer
|
|
44
|
+
} = await import("ws");
|
|
45
|
+
const devtoolsUiHtml = loadDevtoolsUiHtml();
|
|
46
|
+
const httpServer = createHttpServer((req, res) => {
|
|
47
|
+
const url = req.url ?? "/";
|
|
48
|
+
if (url !== "/" && url !== "/index.html") {
|
|
49
|
+
res.statusCode = 404;
|
|
50
|
+
res.end("Not Found");
|
|
51
|
+
return;
|
|
52
|
+
}
|
|
53
|
+
if (!devtoolsUiHtml) {
|
|
54
|
+
res.statusCode = 404;
|
|
55
|
+
res.end("Not Found");
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
res.statusCode = 200;
|
|
59
|
+
res.setHeader("Content-Type", "text/html; charset=utf-8");
|
|
60
|
+
res.end(devtoolsUiHtml);
|
|
61
|
+
});
|
|
62
|
+
const wss = new WebSocketServer({
|
|
63
|
+
server: httpServer
|
|
64
|
+
});
|
|
65
|
+
await new Promise((resolve, reject) => {
|
|
66
|
+
httpServer.once("listening", resolve);
|
|
67
|
+
httpServer.once("error", reject);
|
|
68
|
+
httpServer.listen(options.port);
|
|
69
|
+
});
|
|
70
|
+
const address = httpServer.address();
|
|
71
|
+
const actualPort = typeof address === "object" && address !== null ? address.port : options.port;
|
|
72
|
+
let resolveReady;
|
|
73
|
+
const ready = new Promise(resolve => {
|
|
74
|
+
resolveReady = resolve;
|
|
75
|
+
});
|
|
76
|
+
const clients = new Set();
|
|
77
|
+
const state = {
|
|
78
|
+
port: actualPort,
|
|
79
|
+
connected: false,
|
|
80
|
+
clients,
|
|
81
|
+
httpServer,
|
|
82
|
+
ready,
|
|
83
|
+
close: async () => {
|
|
84
|
+
await new Promise(resolve => wss.close(() => resolve()));
|
|
85
|
+
await new Promise(resolve => httpServer.close(() => resolve()));
|
|
86
|
+
clients.clear();
|
|
87
|
+
state.connected = false;
|
|
88
|
+
}
|
|
89
|
+
};
|
|
90
|
+
wss.on("connection", socket => {
|
|
91
|
+
if (state.connected) {
|
|
92
|
+
socket.close(1000, "Another devtools client is already connected");
|
|
93
|
+
return;
|
|
94
|
+
}
|
|
95
|
+
clients.add(socket);
|
|
96
|
+
state.connected = true;
|
|
97
|
+
resolveReady?.();
|
|
98
|
+
options.onConnection(socket);
|
|
99
|
+
socket.on("message", data => {
|
|
100
|
+
try {
|
|
101
|
+
options.onMessage(JSON.parse(String(data)), socket);
|
|
102
|
+
} catch {
|
|
103
|
+
// ignore malformed messages
|
|
104
|
+
}
|
|
105
|
+
});
|
|
106
|
+
socket.on("close", () => {
|
|
107
|
+
clients.delete(socket);
|
|
108
|
+
state.connected = clients.size > 0;
|
|
109
|
+
options.onDisconnect(socket);
|
|
110
|
+
});
|
|
111
|
+
});
|
|
112
|
+
return state;
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=devtools-transport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["readFileSync","createServer","createHttpServer","cachedAlloyVersion","getAlloyVersion","pkgUrl","URL","import","meta","url","pkg","JSON","parse","version","loadDevtoolsUiHtml","candidates","candidate","createTransport","options","WebSocketServer","devtoolsUiHtml","httpServer","req","res","statusCode","end","setHeader","wss","server","Promise","resolve","reject","once","listen","port","address","actualPort","resolveReady","ready","clients","Set","state","connected","close","clear","on","socket","add","onConnection","data","onMessage","String","delete","size","onDisconnect"],"sources":["../../../../src/devtools/devtools-transport.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["enableDevtools","enableDevtoolsAndConnect","resetDevtoolsServerForTests","waitForDevtoolsConnection"],"sources":["../../../src/devtools-entry.browser.ts"],"sourcesContent":[null],"mappings":"AAsCA,SACEA,cAAc,EACdC,wBAAwB,EACxBC,2BAA2B,EAC3BC,yBAAyB,QACpB,uCAAuC","ignoreList":[]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["enableDevtools","enableDevtoolsAndConnect","resetDevtoolsServerForTests","waitForDevtoolsConnection"],"sources":["../../../src/devtools-entry.ts"],"sourcesContent":[null],"mappings":"AAsCA,SACEA,cAAc,EACdC,wBAAwB,EACxBC,2BAA2B,EAC3BC,yBAAyB,QACpB,+BAA+B","ignoreList":[]}
|