@alloy-js/core 0.3.0 → 0.4.0

package/temp/api.json

@@ -604,10 +604,233 @@
               ],
               "name": "createSymbol"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@alloy-js/core!Binder#findScopeName:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "findScopeName<TScope extends "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputScope",
+                  "canonicalReference": "@alloy-js/core!OutputScope:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputScope",
+                  "canonicalReference": "@alloy-js/core!OutputScope:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(currentScope: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "TScope | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Ref",
+                  "canonicalReference": "@vue/reactivity!Ref:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TScope | undefined>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 9,
+                "endIndex": 11
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "currentScope",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "name",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 8
+                  },
+                  "isOptional": false
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TScope",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
+              "name": "findScopeName"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@alloy-js/core!Binder#findSymbolName:member(1)",
+              "docComment": "/**\n * Find a symbol with a given name in the given scope. Returns a ref for the symbol, such that when the symbol is available, the ref value will update.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "findSymbolName<TScope extends "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputScope",
+                  "canonicalReference": "@alloy-js/core!OutputScope:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputScope",
+                  "canonicalReference": "@alloy-js/core!OutputScope:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", TSymbol extends "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputSymbol",
+                  "canonicalReference": "@alloy-js/core!OutputSymbol:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputSymbol",
+                  "canonicalReference": "@alloy-js/core!OutputSymbol:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(currentScope: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "TScope | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", name: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Ref",
+                  "canonicalReference": "@vue/reactivity!Ref:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TSymbol | undefined>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 13,
+                "endIndex": 15
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "currentScope",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 9,
+                    "endIndex": 10
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "name",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 11,
+                    "endIndex": 12
+                  },
+                  "isOptional": false
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TScope",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                },
+                {
+                  "typeParameterName": "TSymbol",
+                  "constraintTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 8
+                  }
+                }
+              ],
+              "name": "findSymbolName"
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/core!Binder#globalScope:member",
-              "docComment": "",
+              "docComment": "/**\n * The global scope. This is the root scope for all symbols.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -746,42 +969,168 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ", currentMemberScope: "
+                  "text": ", currentMemberScope: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "TScope | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", key: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Refkey",
+                  "canonicalReference": "@alloy-js/core!Refkey:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Ref",
+                  "canonicalReference": "@vue/reactivity!Ref:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ResolutionResult",
+                  "canonicalReference": "@alloy-js/core!ResolutionResult:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TScope, TSymbol> | undefined>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 15,
+                "endIndex": 19
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "currentScope",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 9,
+                    "endIndex": 10
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "currentMemberScope",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 11,
+                    "endIndex": 12
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "key",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 13,
+                    "endIndex": 14
+                  },
+                  "isOptional": false
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TScope",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                },
+                {
+                  "typeParameterName": "TSymbol",
+                  "constraintTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 8
+                  }
+                }
+              ],
+              "name": "resolveDeclarationByKey"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@alloy-js/core!Binder#resolveFQN:member(1)",
+              "docComment": "/**\n * Resolve a fully qualified name to a symbol. Access a nested scope by name with `::`, a nested static member with `.` and a nested instance member with `#`.\n *\n * Per-language packages may provide their own resolveFQN function that uses syntax more natural to that language.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "resolveFQN<TScope extends "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputScope",
+                  "canonicalReference": "@alloy-js/core!OutputScope:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "OutputScope",
+                  "canonicalReference": "@alloy-js/core!OutputScope:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", TSymbol extends "
                 },
                 {
-                  "kind": "Content",
-                  "text": "TScope | undefined"
+                  "kind": "Reference",
+                  "text": "OutputSymbol",
+                  "canonicalReference": "@alloy-js/core!OutputSymbol:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ", key: "
+                  "text": " = "
                 },
                 {
                   "kind": "Reference",
-                  "text": "Refkey",
-                  "canonicalReference": "@alloy-js/core!Refkey:type"
+                  "text": "OutputSymbol",
+                  "canonicalReference": "@alloy-js/core!OutputSymbol:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": ">(fqn: "
                 },
                 {
-                  "kind": "Reference",
-                  "text": "Ref",
-                  "canonicalReference": "@vue/reactivity!Ref:interface"
+                  "kind": "Content",
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": "<"
+                  "text": "): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ResolutionResult",
-                  "canonicalReference": "@alloy-js/core!ResolutionResult:interface"
+                  "text": "Ref",
+                  "canonicalReference": "@vue/reactivity!Ref:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "<TScope, TSymbol> | undefined>"
+                  "text": "<TSymbol | TScope | undefined>"
                 },
                 {
                   "kind": "Content",
@@ -790,35 +1139,19 @@
               ],
               "isOptional": false,
               "returnTypeTokenRange": {
-                "startIndex": 15,
-                "endIndex": 19
+                "startIndex": 11,
+                "endIndex": 13
               },
               "releaseTag": "Public",
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "currentScope",
+                  "parameterName": "fqn",
                   "parameterTypeTokenRange": {
                     "startIndex": 9,
                     "endIndex": 10
                   },
                   "isOptional": false
-                },
-                {
-                  "parameterName": "currentMemberScope",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 11,
-                    "endIndex": 12
-                  },
-                  "isOptional": false
-                },
-                {
-                  "parameterName": "key",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 13,
-                    "endIndex": 14
-                  },
-                  "isOptional": false
                 }
               ],
               "typeParameters": [
@@ -845,7 +1178,7 @@
                   }
                 }
               ],
-              "name": "resolveDeclarationByKey"
+              "name": "resolveFQN"
             }
           ],
           "extendsTokenRanges": []
@@ -1424,6 +1757,33 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/core!ComponentContext#name:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "name?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "name",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/core!ComponentContext#Provider:member",
@@ -1739,6 +2099,38 @@
           "name": "Context",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/core!Context#componentOwner:member",
+              "docComment": "/**\n * When this context was created by a component, this will be the component that created it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "componentOwner?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ComponentCreator",
+                  "canonicalReference": "@alloy-js/core!ComponentCreator:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "componentOwner",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/core!Context#context:member",
@@ -1964,6 +2356,43 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@alloy-js/core!contextsByKey:var",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "contextsByKey: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Map",
+              "canonicalReference": "!Map:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<symbol, "
+            },
+            {
+              "kind": "Reference",
+              "text": "ComponentContext",
+              "canonicalReference": "@alloy-js/core!ComponentContext:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<any>>"
+            }
+          ],
+          "fileUrlPath": "src/context.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "contextsByKey",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 5
+          }
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!createAssignmentContext:function(1)",
@@ -2134,6 +2563,14 @@
               "kind": "Content",
               "text": "T"
             },
+            {
+              "kind": "Content",
+              "text": ", name?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -2154,8 +2591,8 @@
           ],
           "fileUrlPath": "src/context.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 7
+            "startIndex": 7,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -2167,6 +2604,14 @@
                 "endIndex": 4
               },
               "isOptional": true
+            },
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "isOptional": true
             }
           ],
           "typeParameters": [
@@ -2184,6 +2629,85 @@
           ],
           "name": "createContext"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!createNamedContext:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function createNamedContext<T>(name: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ", defaultValue?: "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "ComponentContext",
+              "canonicalReference": "@alloy-js/core!ComponentContext:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/context.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "defaultValue",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "name": "createNamedContext"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!createNamePolicy:function(1)",
@@ -2669,7 +3193,7 @@
             },
             {
               "kind": "Content",
-              "text": "<import(\"@alloy-js/core/jsx-runtime\")."
+              "text": "<import(\"./jsx-runtime.js\")."
             },
             {
               "kind": "Reference",
@@ -6832,7 +7356,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@alloy-js/core!ResolutionResult:interface",
-          "docComment": "/**\n * A successful resolution of a refkey.\n *\n * @example\n *\n * Let's say we have the following scopes and symbols:\n * ```\n * scope: global scope\n * ├── scope: namespace scope 1\n * │   └── symbol: foo\n * │       └── static member scope\n * │           └── symbol: bar\n * └── scope: namespace scope 2\n *    └── (resolve bar from here)\n * ```\n *\n * When we resolve the refkey for `bar` from within `namespace scope 2`, we will get the following resolution result:\n *\n * * **targetDeclaration**: symbol bar, the symbol we resolved. * **commonScope**: global scope, because this is the most specific scope that contains both the declaration and the reference. * **pathUp**: [namespace scope 2], because this is the scope between the reference and the common scope. * **pathDown**: [namespace scope 1], because this is the scope between the common scope and the declaration * **memberPath**: [foo, bar], because we resolved a member symbol and these are the symbols that lead from the base declaration to the member symbol.\n */\n",
+          "docComment": "/**\n * A successful resolution of a refkey.\n *\n * @example\n *\n * Let's say we have the following scopes and symbols:\n * ```\n * scope: global scope\n * ├── scope: namespace scope 1\n * │   └── symbol: foo\n * │       └── static member scope\n * │           └── symbol: bar\n * └── scope: namespace scope 2\n *    └── (resolve bar from here)\n * ```\n *\n * When we resolve the refkey for `bar` from within `namespace scope 2`, we will get the following resolution result:\n *\n * **targetDeclaration**: symbol bar, the symbol we resolved.\n *\n * **commonScope**: global scope, because this is the most specific scope that contains both the declaration and the reference.\n *\n * **pathUp**: [namespace scope 2], because this is the scope between the reference and the common scope.\n *\n * **pathDown**: [namespace scope 1], because this is the scope between the common scope and the declaration\n *\n * **memberPath**: [foo, bar], because we resolved a member symbol and these are the symbols that lead from the base declaration to the member symbol.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7150,11 +7674,16 @@
             },
             {
               "kind": "Content",
-              "text": ", src?: "
+              "text": ", componentOwner?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ComponentCreator",
+              "canonicalReference": "@alloy-js/core!ComponentCreator:interface"
             },
             {
               "kind": "Content",
-              "text": "string"
+              "text": "<any>"
             },
             {
               "kind": "Content",
@@ -7171,8 +7700,8 @@
           ],
           "fileUrlPath": "src/jsx-runtime.ts",
           "returnTypeTokenRange": {
-            "startIndex": 7,
-            "endIndex": 8
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -7186,10 +7715,10 @@
               "isOptional": false
             },
             {
-              "parameterName": "src",
+              "parameterName": "componentOwner",
               "parameterTypeTokenRange": {
                 "startIndex": 5,
-                "endIndex": 6
+                "endIndex": 7
               },
               "isOptional": true
             }
@@ -7420,29 +7949,6 @@
           ],
           "extendsTokenRanges": []
         },
-        {
-          "kind": "Variable",
-          "canonicalReference": "@alloy-js/core!shouldDebug:var",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "shouldDebug: "
-            },
-            {
-              "kind": "Content",
-              "text": "boolean"
-            }
-          ],
-          "fileUrlPath": "src/jsx-runtime.ts",
-          "isReadonly": true,
-          "releaseTag": "Public",
-          "name": "shouldDebug",
-          "variableTypeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          }
-        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!SourceDirectory:function(1)",
@@ -8834,7 +9340,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "src/utils.ts",
+          "fileUrlPath": "src/write-output.ts",
           "returnTypeTokenRange": {
             "startIndex": 5,
             "endIndex": 6