@alloy-js/core 0.23.0-dev.8 → 0.23.0-dev.9

package/src/symbols/symbol-flow.ts

@@ -1,5 +1,11 @@
-import { isRef, Ref, shallowReactive } from "@vue/reactivity";
-import { Context, effect, getContext, onCleanup } from "../reactivity.js";
+import { isRef, Ref } from "@vue/reactivity";
+import {
+  Context,
+  effect,
+  getContext,
+  onCleanup,
+  shallowReactive,
+} from "../reactivity.js";
 
 import { MemberContext } from "../context/member-scope.js";
 import { ScopeContext } from "../context/scope.js";

package/src/utils.tsx

@@ -5,6 +5,7 @@ import {
   CustomContext,
   Disposable,
   effect,
+  ensureIsEmpty,
   getContext,
   memo,
   onCleanup,
@@ -278,9 +279,6 @@ export function mapJoin<T, U, V>(
     }
 
     const context = getContext();
-    if (context) {
-      context.isEmpty ??= ref(true);
-    }
     // this is important to access here in reactive context so we are
     // notified of new items from reactives.
     const itemsLen = items.length;
@@ -326,7 +324,7 @@ export function mapJoin<T, U, V>(
         mapped[startIndex * 2] = createCustomContext((cb) => {
           return root((disposer) => {
             const nestedContext = getContext()!;
-            const isEmptyFlag = nestedContext.isEmpty!;
+            const isEmptyFlag = ensureIsEmpty(nestedContext);
 
             slot.disposer = disposer;
             disposer();

package/temp/api.json

@@ -3634,6 +3634,33 @@
           "name": "Context",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/core!Context#_lastEmpty:member",
+              "docComment": "/**\n * Cheap boolean tracking the last propagated empty state.\n * Used by notifyContentState() for early-return optimization\n * without requiring a reactive ref on every context.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "_lastEmpty: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "_lastEmpty",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/core!Context#childrenWithContent:member",
@@ -3732,7 +3759,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "disposables: "
+                  "text": "disposables?: "
                 },
                 {
                   "kind": "Reference",
@@ -3749,7 +3776,7 @@
                 }
               ],
               "isReadonly": false,
-              "isOptional": false,
+              "isOptional": true,
               "releaseTag": "Public",
               "name": "disposables",
               "propertyTypeTokenRange": {
@@ -3764,7 +3791,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "elementCache: "
+                  "text": "elementCache?: "
                 },
                 {
                   "kind": "Reference",
@@ -3777,7 +3804,7 @@
                 }
               ],
               "isReadonly": false,
-              "isOptional": false,
+              "isOptional": true,
               "releaseTag": "Public",
               "name": "elementCache",
               "propertyTypeTokenRange": {
@@ -3785,10 +3812,37 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@alloy-js/core!Context#id:member",
+              "docComment": "/**\n * Monotonic numeric ID for trace/debug correlation.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "id",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@alloy-js/core!Context#isEmpty:member",
-              "docComment": "/**\n * A ref that indicates whether the component is empty.\n */\n",
+              "docComment": "/**\n * A ref that indicates whether the component is empty.\n * Only allocated when reactively observed (ContentSlot, mapJoin).\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7770,6 +7824,57 @@
           ],
           "name": "emitSymbol"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!ensureIsEmpty:function(1)",
+          "docComment": "/**\n * Ensure that a context has an isEmpty ref, creating one if needed.\n * Only call this when you need to reactively observe isEmpty (e.g.,\n * ContentSlot, mapJoin). Most contexts don't need an isEmpty ref.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function ensureIsEmpty(context: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Context",
+              "canonicalReference": "@alloy-js/core!Context:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Ref",
+              "canonicalReference": "@vue/reactivity!Ref:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<boolean>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 5
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "context",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "ensureIsEmpty"
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@alloy-js/core!FillIntrinsicElement:type",
@@ -7801,6 +7906,34 @@
             "endIndex": 3
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!findCurrentEffectId:function(1)",
+          "docComment": "/**\n * Walk up the context owner chain to find the nearest effect ID.\n * Used to attribute reactive mutations to the effect that caused them.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function findCurrentEffectId(): "
+            },
+            {
+              "kind": "Content",
+              "text": "number | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "findCurrentEffectId"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!findKeyedChild:function(1)",
@@ -8702,6 +8835,51 @@
           ],
           "name": "getDiagnosticsForTree"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!getEffectDebugId:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getEffectDebugId(effect: "
+            },
+            {
+              "kind": "Content",
+              "text": "object"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "number | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "effect",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getEffectDebugId"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!getElementCache:function(1)",
@@ -8713,8 +8891,12 @@
             },
             {
               "kind": "Reference",
-              "text": "ElementCache",
-              "canonicalReference": "@alloy-js/core!ElementCache:type"
+              "text": "Map",
+              "canonicalReference": "!Map:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<any, any>"
             },
             {
               "kind": "Content",
@@ -8724,13 +8906,67 @@
           "fileUrlPath": "src/reactivity.ts",
           "returnTypeTokenRange": {
             "startIndex": 1,
-            "endIndex": 2
+            "endIndex": 3
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
           "parameters": [],
           "name": "getElementCache"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!getReactiveCreationLocation:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getReactiveCreationLocation(target: "
+            },
+            {
+              "kind": "Content",
+              "text": "object"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "import(\"./devtools-entry.browser.js\")."
+            },
+            {
+              "kind": "Reference",
+              "text": "SourceLocation",
+              "canonicalReference": "@alloy-js/core!~SourceLocation:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "target",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getReactiveCreationLocation"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!getSymbolCreator:function(1)",
@@ -13591,6 +13827,14 @@
               "kind": "Content",
               "text": "boolean"
             },
+            {
+              "kind": "Content",
+              "text": ", name?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -13606,8 +13850,8 @@
           ],
           "fileUrlPath": "src/reactivity.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 7,
+            "endIndex": 8
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -13627,6 +13871,14 @@
                 "endIndex": 4
               },
               "isOptional": true
+            },
+            {
+              "parameterName": "name",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "isOptional": true
             }
           ],
           "typeParameters": [
@@ -14663,6 +14915,34 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!nextReactiveId:function(1)",
+          "docComment": "/**\n * Allocate a unique reactive target ID from the same counter space as ref IDs.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function nextReactiveId(): "
+            },
+            {
+              "kind": "Content",
+              "text": "number"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "nextReactiveId"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!notifyContentState:function(1)",
@@ -19679,6 +19959,14 @@
               "kind": "Content",
               "text": "T"
             },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    isInfrastructure?: boolean;\n}"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -19699,8 +19987,8 @@
           ],
           "fileUrlPath": "src/reactivity.ts",
           "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 5
+            "startIndex": 5,
+            "endIndex": 7
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -19712,6 +20000,14 @@
                 "endIndex": 2
               },
               "isOptional": true
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
             }
           ],
           "typeParameters": [
@@ -20110,6 +20406,14 @@
               "kind": "Content",
               "text": "<unknown>"
             },
+            {
+              "kind": "Content",
+              "text": ", isInfrastructure?: "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -20125,8 +20429,8 @@
           ],
           "fileUrlPath": "src/reactivity.ts",
           "returnTypeTokenRange": {
-            "startIndex": 4,
-            "endIndex": 5
+            "startIndex": 6,
+            "endIndex": 7
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -20138,6 +20442,14 @@
                 "endIndex": 3
               },
               "isOptional": false
+            },
+            {
+              "parameterName": "isInfrastructure",
+              "parameterTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "isOptional": true
             }
           ],
           "name": "refId"
@@ -20693,6 +21005,34 @@
           ],
           "name": "reportDiagnostics"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!resetRefIdCounter:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function resetRefIdCounter(): "
+            },
+            {
+              "kind": "Content",
+              "text": "void"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "resetRefIdCounter"
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@alloy-js/core!ResolutionResult:interface",
@@ -21793,6 +22133,77 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@alloy-js/core!shallowReactive:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function shallowReactive<T extends "
+            },
+            {
+              "kind": "Content",
+              "text": "object"
+            },
+            {
+              "kind": "Content",
+              "text": ">(target: "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "ShallowReactive",
+              "canonicalReference": "@vue/reactivity!ShallowReactive:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/reactivity.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "target",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "name": "shallowReactive"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@alloy-js/core!shallowRef:function(1)",