@alloy-js/python 0.4.0-dev.2 → 0.4.0-dev.5

package/temp/api.json

@@ -209,6 +209,51 @@
             "endIndex": 5
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/python!AddImportOptions:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AddImportOptions "
+            }
+          ],
+          "fileUrlPath": "src/symbols/python-module-scope.ts",
+          "releaseTag": "Public",
+          "name": "AddImportOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/python!AddImportOptions#type:member",
+              "docComment": "/**\n * If true, this import is only used in type annotation contexts.\n * Such imports will be guarded with `if TYPE_CHECKING:`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "type?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "type",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/python!Atom:function(1)",
@@ -5283,32 +5328,33 @@
         },
         {
           "kind": "Function",
-          "canonicalReference": "@alloy-js/python!ImportStatement:function(1)",
-          "docComment": "/**\n * A Python import statement.\n *\n * @remarks\n *\n *\n * This component renders an import statement for a given path and symbols.\n * If no symbols are provided, it will render a simple import statement.\n * If symbols are provided, it will render an import statement with the specified symbols.\n *\n * @example\n * ```tsx\n * <ImportStatement path=\"os\" />\n * <ImportStatement path=\"math\" symbols={new Set([new ImportedSymbol(\"sqrt\", \"sqrt\")])} />\n * ```\n *\n * This will generate:\n * ```python\n * import os\n * from math import sqrt\n * ```\n *\n */\n",
+          "canonicalReference": "@alloy-js/python!InlineDoc:function(1)",
+          "docComment": "/**\n * An inline documentation component for attribute docstrings.\n * Unlike PyDoc, this doesn't add a trailing line break after the closing quotes,\n * which is appropriate for documenting consecutive attributes like enum members.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function ImportStatement(props: "
+              "text": "export declare function InlineDoc(props: "
             },
             {
               "kind": "Reference",
-              "text": "ImportStatementProps",
-              "canonicalReference": "@alloy-js/python!ImportStatementProps:interface"
+              "text": "InlineDocProps",
+              "canonicalReference": "@alloy-js/python!InlineDocProps:interface"
             },
             {
               "kind": "Content",
               "text": "): "
             },
             {
-              "kind": "Content",
-              "text": "() => any[]"
+              "kind": "Reference",
+              "text": "Children",
+              "canonicalReference": "@alloy-js/core!Children:type"
             },
             {
               "kind": "Content",
               "text": ";"
             }
           ],
-          "fileUrlPath": "src/components/ImportStatement.tsx",
+          "fileUrlPath": "src/components/PyDoc.tsx",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -5325,35 +5371,36 @@
               "isOptional": false
             }
           ],
-          "name": "ImportStatement"
+          "name": "InlineDoc"
         },
         {
           "kind": "Interface",
-          "canonicalReference": "@alloy-js/python!ImportStatementProps:interface",
+          "canonicalReference": "@alloy-js/python!InlineDocProps:interface",
           "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export interface ImportStatementProps "
+              "text": "export interface InlineDocProps "
             }
           ],
-          "fileUrlPath": "src/components/ImportStatement.tsx",
+          "fileUrlPath": "src/components/PyDoc.tsx",
           "releaseTag": "Public",
-          "name": "ImportStatementProps",
+          "name": "InlineDocProps",
           "preserveMemberOrder": false,
           "members": [
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/python!ImportStatementProps#path:member",
+              "canonicalReference": "@alloy-js/python!InlineDocProps#children:member",
               "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "path: "
+                  "text": "children: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "string"
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
                 },
                 {
                   "kind": "Content",
@@ -5363,93 +5410,52 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Public",
-              "name": "path",
+              "name": "children",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
               }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/python!ImportStatementProps#symbols:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "symbols?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Set",
-                  "canonicalReference": "!Set:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<"
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ImportedSymbol",
-                  "canonicalReference": "@alloy-js/python!ImportedSymbol:class"
-                },
-                {
-                  "kind": "Content",
-                  "text": ">"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "symbols",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 5
-              }
             }
           ],
           "extendsTokenRanges": []
         },
         {
           "kind": "Function",
-          "canonicalReference": "@alloy-js/python!ImportStatements:function(1)",
-          "docComment": "/**\n * A component that renders import statements based on the provided import records.\n *\n * @remarks\n *\n *\n * This component will render import statements for each module and its symbols.\n * If `joinImportsFromSameModule` is true, it will group imports from the same module\n * into a single statement.\n */\n",
+          "canonicalReference": "@alloy-js/python!isParameterDescriptor:function(1)",
+          "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function ImportStatements(props: "
-            },
-            {
-              "kind": "Reference",
-              "text": "ImportStatementsProps",
-              "canonicalReference": "@alloy-js/python!ImportStatementsProps:interface"
+              "text": "export declare function isParameterDescriptor(param: "
             },
             {
               "kind": "Content",
-              "text": "): "
+              "text": "unknown"
             },
             {
               "kind": "Content",
-              "text": "() => import(\"@alloy-js/core\")."
+              "text": "): "
             },
             {
               "kind": "Reference",
-              "text": "Children",
-              "canonicalReference": "@alloy-js/core!Children:type"
+              "text": "param",
+              "canonicalReference": "@alloy-js/python!~param"
             },
             {
               "kind": "Content",
-              "text": "[]"
+              "text": " is "
+            },
+            {
+              "kind": "Reference",
+              "text": "ParameterDescriptor",
+              "canonicalReference": "@alloy-js/python!ParameterDescriptor:interface"
             },
             {
               "kind": "Content",
               "text": ";"
             }
           ],
-          "fileUrlPath": "src/components/ImportStatement.tsx",
+          "fileUrlPath": "src/parameter-descriptor.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 6
@@ -5458,7 +5464,7 @@
           "overloadIndex": 1,
           "parameters": [
             {
-              "parameterName": "props",
+              "parameterName": "param",
               "parameterTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -5466,99 +5472,89 @@
               "isOptional": false
             }
           ],
-          "name": "ImportStatements"
+          "name": "isParameterDescriptor"
         },
         {
-          "kind": "Interface",
-          "canonicalReference": "@alloy-js/python!ImportStatementsProps:interface",
-          "docComment": "",
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/python!isTypeRefContext:function(1)",
+          "docComment": "/**\n * @returns  'true' if in a type context, 'false' if in a value context.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export interface ImportStatementsProps "
+              "text": "export declare function isTypeRefContext(): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
             }
           ],
-          "fileUrlPath": "src/components/ImportStatement.tsx",
+          "fileUrlPath": "src/context/type-ref-context.tsx",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
           "releaseTag": "Public",
-          "name": "ImportStatementsProps",
-          "preserveMemberOrder": false,
-          "members": [
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "isTypeRefContext"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/python!LeixcalScopePropsWithScopeInfo:interface",
+          "docComment": "",
+          "excerptTokens": [
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/python!ImportStatementsProps#joinImportsFromSameModule:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "joinImportsFromSameModule?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "joinImportsFromSameModule",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
+              "kind": "Content",
+              "text": "export interface LeixcalScopePropsWithScopeInfo extends "
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/python!ImportStatementsProps#records:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "records: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ImportRecords",
-                  "canonicalReference": "@alloy-js/python!ImportRecords:class"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "records",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
+              "kind": "Reference",
+              "text": "ScopePropsWithInfo",
+              "canonicalReference": "@alloy-js/core!ScopePropsWithInfo:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
             }
           ],
-          "extendsTokenRanges": []
+          "fileUrlPath": "src/components/LexicalScope.tsx",
+          "releaseTag": "Public",
+          "name": "LeixcalScopePropsWithScopeInfo",
+          "preserveMemberOrder": false,
+          "members": [],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
         },
         {
           "kind": "Function",
-          "canonicalReference": "@alloy-js/python!InlineDoc:function(1)",
-          "docComment": "/**\n * An inline documentation component for attribute docstrings.\n * Unlike PyDoc, this doesn't add a trailing line break after the closing quotes,\n * which is appropriate for documenting consecutive attributes like enum members.\n */\n",
+          "canonicalReference": "@alloy-js/python!LexicalScope:function(1)",
+          "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function InlineDoc(props: "
+              "text": "export declare function LexicalScope(props: "
             },
             {
               "kind": "Reference",
-              "text": "InlineDocProps",
-              "canonicalReference": "@alloy-js/python!InlineDocProps:interface"
+              "text": "LexicalScopeProps",
+              "canonicalReference": "@alloy-js/python!LexicalScopeProps:type"
             },
             {
               "kind": "Content",
               "text": "): "
             },
+            {
+              "kind": "Content",
+              "text": "import(\"@alloy-js/core\")."
+            },
             {
               "kind": "Reference",
               "text": "Children",
@@ -5569,10 +5565,10 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "src/components/PyDoc.tsx",
+          "fileUrlPath": "src/components/LexicalScope.tsx",
           "returnTypeTokenRange": {
             "startIndex": 3,
-            "endIndex": 4
+            "endIndex": 5
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -5586,200 +5582,17 @@
               "isOptional": false
             }
           ],
-          "name": "InlineDoc"
+          "name": "LexicalScope"
         },
         {
-          "kind": "Interface",
-          "canonicalReference": "@alloy-js/python!InlineDocProps:interface",
+          "kind": "TypeAlias",
+          "canonicalReference": "@alloy-js/python!LexicalScopeProps:type",
           "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export interface InlineDocProps "
-            }
-          ],
-          "fileUrlPath": "src/components/PyDoc.tsx",
-          "releaseTag": "Public",
-          "name": "InlineDocProps",
-          "preserveMemberOrder": false,
-          "members": [
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@alloy-js/python!InlineDocProps#children:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "children: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Children",
-                  "canonicalReference": "@alloy-js/core!Children:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "children",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            }
-          ],
-          "extendsTokenRanges": []
-        },
-        {
-          "kind": "Function",
-          "canonicalReference": "@alloy-js/python!isParameterDescriptor:function(1)",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare function isParameterDescriptor(param: "
-            },
-            {
-              "kind": "Content",
-              "text": "unknown"
-            },
-            {
-              "kind": "Content",
-              "text": "): "
-            },
-            {
-              "kind": "Reference",
-              "text": "param",
-              "canonicalReference": "@alloy-js/python!~param"
-            },
-            {
-              "kind": "Content",
-              "text": " is "
-            },
-            {
-              "kind": "Reference",
-              "text": "ParameterDescriptor",
-              "canonicalReference": "@alloy-js/python!ParameterDescriptor:interface"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/parameter-descriptor.ts",
-          "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 6
-          },
-          "releaseTag": "Public",
-          "overloadIndex": 1,
-          "parameters": [
-            {
-              "parameterName": "param",
-              "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isOptional": false
-            }
-          ],
-          "name": "isParameterDescriptor"
-        },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@alloy-js/python!LeixcalScopePropsWithScopeInfo:interface",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface LeixcalScopePropsWithScopeInfo extends "
-            },
-            {
-              "kind": "Reference",
-              "text": "ScopePropsWithInfo",
-              "canonicalReference": "@alloy-js/core!ScopePropsWithInfo:interface"
-            },
-            {
-              "kind": "Content",
-              "text": " "
-            }
-          ],
-          "fileUrlPath": "src/components/LexicalScope.tsx",
-          "releaseTag": "Public",
-          "name": "LeixcalScopePropsWithScopeInfo",
-          "preserveMemberOrder": false,
-          "members": [],
-          "extendsTokenRanges": [
-            {
-              "startIndex": 1,
-              "endIndex": 2
-            }
-          ]
-        },
-        {
-          "kind": "Function",
-          "canonicalReference": "@alloy-js/python!LexicalScope:function(1)",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare function LexicalScope(props: "
-            },
-            {
-              "kind": "Reference",
-              "text": "LexicalScopeProps",
-              "canonicalReference": "@alloy-js/python!LexicalScopeProps:type"
-            },
-            {
-              "kind": "Content",
-              "text": "): "
-            },
-            {
-              "kind": "Content",
-              "text": "import(\"@alloy-js/core\")."
-            },
-            {
-              "kind": "Reference",
-              "text": "Children",
-              "canonicalReference": "@alloy-js/core!Children:type"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/components/LexicalScope.tsx",
-          "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 5
-          },
-          "releaseTag": "Public",
-          "overloadIndex": 1,
-          "parameters": [
-            {
-              "parameterName": "props",
-              "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isOptional": false
-            }
-          ],
-          "name": "LexicalScope"
-        },
-        {
-          "kind": "TypeAlias",
-          "canonicalReference": "@alloy-js/python!LexicalScopeProps:type",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export type LexicalScopeProps = "
-            },
+              "text": "export type LexicalScopeProps = "
+            },
             {
               "kind": "Reference",
               "text": "LexicalScopePropsWithScopeValue",
@@ -5907,7 +5720,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "Part: (props: "
+                  "text": "Part: (_props: "
                 },
                 {
                   "kind": "Reference",
@@ -5931,7 +5744,7 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "props",
+                  "parameterName": "_props",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -8889,6 +8702,15 @@
                   "text": "PythonModuleScope",
                   "canonicalReference": "@alloy-js/python!PythonModuleScope:class"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AddImportOptions",
+                  "canonicalReference": "@alloy-js/python!AddImportOptions:interface"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -8905,8 +8727,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
+                "startIndex": 7,
+                "endIndex": 8
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -8927,12 +8749,52 @@
                     "endIndex": 4
                   },
                   "isOptional": false
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
               "name": "addImport"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@alloy-js/python!PythonModuleScope#addTypeImport:member(1)",
+              "docComment": "/**\n * Add TYPE_CHECKING import from the typing module.\n * Returns the local symbol for use in the if block opener.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "addTypeImport(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PythonOutputSymbol",
+                  "canonicalReference": "@alloy-js/python!PythonOutputSymbol:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "addTypeImport"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@alloy-js/python!PythonModuleScope#debugInfo:member",
@@ -9375,6 +9237,67 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@alloy-js/python!PythonOutputSymbol#isTypeOnly:member",
+              "docComment": "/**\n * Returns true if this symbol is only used in type annotation contexts.\n * Such symbols can be imported inside a TYPE_CHECKING block.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get isTypeOnly(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "isTypeOnly",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@alloy-js/python!PythonOutputSymbol#markAsValue:member(1)",
+              "docComment": "/**\n * Mark this symbol as also being used as a value (not just a type).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "markAsValue(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "markAsValue"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@alloy-js/python!PythonOutputSymbol.memberSpaces:member",
@@ -9527,6 +9450,33 @@
                 "startIndex": 1,
                 "endIndex": 2
               }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/python!PythonOutputSymbolOptions#typeOnly:member",
+              "docComment": "/**\n * Whether this symbol is only used in type annotation contexts\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "typeOnly?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "typeOnly",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             }
           ],
           "extendsTokenRanges": [
@@ -9660,6 +9610,15 @@
               "text": "Refkey",
               "canonicalReference": "@alloy-js/core!Refkey:type"
             },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "RefOptions",
+              "canonicalReference": "@alloy-js/python!RefOptions:interface"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -9693,8 +9652,8 @@
           ],
           "fileUrlPath": "src/symbols/reference.tsx",
           "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 8
+            "startIndex": 5,
+            "endIndex": 10
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -9706,6 +9665,14 @@
                 "endIndex": 2
               },
               "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
             }
           ],
           "name": "ref"
@@ -9807,6 +9774,51 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/python!RefOptions:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface RefOptions "
+            }
+          ],
+          "fileUrlPath": "src/symbols/reference.tsx",
+          "releaseTag": "Public",
+          "name": "RefOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/python!RefOptions#type:member",
+              "docComment": "/**\n * If true, this reference is only used in a type annotation context.\n * The import will be guarded with `if TYPE_CHECKING:`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "type?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "type",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@alloy-js/python!requestsModule:var",
@@ -10162,6 +10174,10 @@
                   "text": "Children",
                   "canonicalReference": "@alloy-js/core!Children:type"
                 },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
                 {
                   "kind": "Content",
                   "text": ";"
@@ -10173,7 +10189,7 @@
               "name": "futureImports",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               }
             },
             {
@@ -10693,10 +10709,99 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/python!TypeRefContext:function(1)",
+          "docComment": "/**\n * Set the current context of reference to be type reference.\n *\n * @remarks\n *\n *\n * References used inside the children of this component will be treated as\n * type-only references. When a symbol is only referenced in type contexts,\n * it will be imported inside a `if TYPE_CHECKING:` block.\n *\n * @example\n * ```tsx\n * <TypeRefContext>\n *   {someTypeRefkey}\n * </TypeRefContext>\n * ```\n *\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "TypeRefContext: ({ children }: "
+            },
+            {
+              "kind": "Reference",
+              "text": "TypeRefContextProps",
+              "canonicalReference": "@alloy-js/python!TypeRefContextProps:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Reference",
+              "text": "Children",
+              "canonicalReference": "@alloy-js/core!Children:type"
+            }
+          ],
+          "fileUrlPath": "src/components/TypeRefContext.tsx",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "{ children }",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "TypeRefContext"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@alloy-js/python!TypeRefContextProps:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface TypeRefContextProps "
+            }
+          ],
+          "fileUrlPath": "src/components/TypeRefContext.tsx",
+          "releaseTag": "Public",
+          "name": "TypeRefContextProps",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/python!TypeRefContextProps#children:member",
+              "docComment": "/**\n * Children\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "children: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Children",
+                  "canonicalReference": "@alloy-js/core!Children:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "children",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/python!TypeReference:function(1)",
-          "docComment": "/**\n * A type reference like Foo[T, P] or int.\n */\n",
+          "docComment": "/**\n * A type reference like Foo[T, P] or int.\n *\n * @remarks\n *\n *\n * This component automatically wraps its content in a type reference context,\n * so any symbols referenced via refkey will be imported as type-only\n * (inside a `if TYPE_CHECKING:` block) unless also used as values elsewhere.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",