@neocompose/cli 0.76.3 → 0.77.0

package/dist/neo.mjs

@@ -4183,7 +4183,10 @@ function isMemberEnum(value) {
   if (!isWithId(value)) return false;
   return isWithId(value);
 }
-function isMemberLookupBase(value) {
+function isLookupSelection(selection2) {
+  return selection2 === void 0 || selection2 === 0 /* Single */ || selection2 === 1 /* Multi */;
+}
+function isMemberCollectionLookupBase(value) {
   const v = asMemberBaseForKind(value, 9 /* Lookup */);
   if (v === null) return false;
   if (typeof v.collectionMemberId !== "string") return false;
@@ -4194,7 +4197,39 @@ function isMemberLookupBase(value) {
   if (v.declaredTypeInfo !== void 0 && v.declaredTypeInfo !== null && !isNSTypeInfo(v.declaredTypeInfo)) {
     return false;
   }
-  return v.selection === void 0 || v.selection === 0 /* Single */ || v.selection === 1 /* Multi */;
+  return isLookupSelection(v.selection);
+}
+function isMemberTypeLookupBase(value) {
+  const v = asMemberBaseForKind(value, 9 /* Lookup */);
+  if (v === null) return false;
+  if (v.collectionMemberId !== void 0) return false;
+  if (v.collectionValueId !== void 0) return false;
+  if (!isLookupTargetTypeInfo(v.declaredTypeInfo)) return false;
+  return isLookupSelection(v.selection);
+}
+function isLookupTargetTypeInfo(value) {
+  if (!isNSTypeInfo(value)) return false;
+  return value.type === 7 /* Class */ || value.type === 21 /* Generic */;
+}
+function lookupShapeViolation(value) {
+  const v = asMemberBaseForKind(value, 9 /* Lookup */);
+  if (v === null) return null;
+  if (v.extendsMemberId !== void 0) return null;
+  if (v.collectionMemberId !== void 0) return null;
+  const id2 = String(v.id);
+  if (v.declaredTypeInfo === void 0 || v.declaredTypeInfo === null) {
+    return `Lookup member \`${id2}\` has neither a collection nor a declared type.`;
+  }
+  if (v.collectionValueId !== void 0) {
+    return `Lookup member \`${id2}\` names a collection value without a collection.`;
+  }
+  if (!isLookupTargetTypeInfo(v.declaredTypeInfo)) {
+    return `Lookup member \`${id2}\` has no collection, so its declared type must be a class or generic parameter.`;
+  }
+  return null;
+}
+function isMemberLookupBase(value) {
+  return isMemberCollectionLookupBase(value) || isMemberTypeLookupBase(value);
 }
 function isMemberLookup(value) {
   if (!isMemberLookupBase(value)) return false;
@@ -9053,6 +9088,13 @@ function resolveGenericScope(classId, classes, draft) {
   }
   return scope;
 }
+function genericParamClassConstraintId(typeInfo, classById) {
+  const constraint = classById.get(typeInfo.ownerClassId)?.genericParams?.find(
+    (param) => param.id === typeInfo.genericParamId
+  )?.constraint;
+  if (!constraint || !isClassGenericConstraint(constraint)) return null;
+  return constraint.classId;
+}
 function findGenericParamDeclaration(genericParamId, classes) {
   for (const schemaClass2 of classes) {
     for (const param of schemaClass2.genericParams ?? []) {
@@ -17581,6 +17623,15 @@ function neoSourceTypeText(type) {
   const args = type.typeArguments.length > 0 ? `<${type.typeArguments.map(neoSourceTypeText).join(", ")}>` : "";
   return `${type.name}${args}${type.nullable ? "?" : ""}`;
 }
+function referenceReadType(type) {
+  const target = type.name === "Reference" ? type.typeArguments[0] : void 0;
+  if (target !== void 0) return { ...target, nullable: type.nullable };
+  const element = type.name === "Set" ? type.typeArguments[0] : void 0;
+  if (element?.name !== "Reference" || element.typeArguments.length === 0) {
+    return type;
+  }
+  return { ...type, typeArguments: [referenceReadType(element)] };
+}
 function isNeoSourceAccessModifier(value) {
   return value === "public" || value === "protected" || value === "private";
 }
@@ -25852,6 +25903,13 @@ function ownershipForMemberStorage(ctx, memberId) {
 }
 function sourceForMemberRecord(ctx, memberId, member, inheritedOwnership) {
   if (isMemberLookupBase(member)) {
+    if (member.collectionMemberId === void 0) {
+      return {
+        memberId,
+        typeInfo: memberTypeInfoForCodegen(ctx, member),
+        ownership: null
+      };
+    }
     const entryMember = resolveLookupEntryMember(ctx, member);
     const ownership = ownershipForMemberStorage(ctx, member.collectionMemberId) ?? inheritedOwnership;
     return {
@@ -25913,6 +25971,10 @@ function memberTypeInfoForCodegen(ctx, member) {
     return { type: 7 /* Class */, required: required2, classId: member.classId };
   }
   if (isMemberLookupBase(member)) {
+    if (member.collectionMemberId === void 0) {
+      const entryTypeInfo2 = { ...member.declaredTypeInfo, required: true };
+      return isMultiSelectionMember(member) ? { type: 9 /* Lookup */, required: required2, entryTypeInfo: entryTypeInfo2 } : withRequiredTypeInfo(entryTypeInfo2, false);
+    }
     const entryMember = resolveLookupEntryMember(ctx, member);
     if (entryMember === null) return { type: 0 /* Null */, required: false };
     const entryTypeInfo = withRequiredTypeInfo(
@@ -26058,6 +26120,15 @@ function lookupTargetClassProjection(ctx, member, env) {
     constructedSuffix: constructedTypeArgumentsSuffix(ctx, bindingMember, true, env) ?? ""
   };
 }
+function lookupTargetsClass(ctx, member) {
+  if (!isMemberLookupBase(member)) return false;
+  if (member.collectionMemberId === void 0) return true;
+  const entryMember = resolveLookupEntryMember(ctx, member);
+  return entryMember !== null && isMemberClassBase(entryMember);
+}
+function lookupHasRuntimeOwnership(member) {
+  return isMemberLookupBase(member) && member.collectionMemberId === void 0;
+}
 function lookupNarrowsThroughGenericParam(member) {
   return lookupDeclaredTypeInfo(member)?.type === 21 /* Generic */;
 }
@@ -26094,6 +26165,7 @@ function lookupTargetValueType(ctx, member, saved, env) {
 }
 function lookupTargetSaved(ctx, member) {
   if (!isMemberLookupBase(member)) return null;
+  if (member.collectionMemberId === void 0) return false;
   const storages = ctx.storageResolver.effectiveStorages(
     member.collectionMemberId
   );
@@ -26104,6 +26176,7 @@ function lookupTargetSaved(ctx, member) {
 }
 function resolveLookupEntryMember(ctx, member) {
   if (!isMemberLookupBase(member)) return null;
+  if (member.collectionMemberId === void 0) return null;
   const collectionMember = resolveMemberById(
     ctx,
     member.collectionMemberId,
@@ -27433,7 +27506,7 @@ function validateDocumentAccessModifiers(ctx) {
         });
       }
     }
-    if (isMemberLookupBase(member)) {
+    if (isMemberCollectionLookupBase(member)) {
       validateLookupTargetAccess({
         lookup: member,
         membersById,
@@ -30400,6 +30473,12 @@ function bindConstructorArgumentNames(className, declared, argumentNames, pos) {
     return parameter4.name;
   });
 }
+function localOwnership(initial) {
+  if (initial.entryWritability !== void 0 && (initial.type.kind === "named" || initial.type.kind === "typeParameter")) {
+    return initial.entryWritability;
+  }
+  return initial.writability ?? "local" /* Local */;
+}
 function scopeVariable(name, value, sourceType, writability, ownership, writeRoot, readonlyBinding) {
   return {
     name,
@@ -32428,7 +32507,7 @@ var init_strict_resolver = __esm({
                 local,
                 localType,
                 "local" /* Local */,
-                initial.writability ?? "local" /* Local */,
+                localOwnership(initial),
                 this.localWriteTargetRoot(initial, scope)
               )
             );
@@ -35681,6 +35760,7 @@ var init_strict_resolver = __esm({
             } : {}
           };
         }
+        const writability = member.writability ? toWritability(member.writability, this.writesUserData) : void 0;
         return {
           pointer: {
             type: "staticMember" /* StaticMember */,
@@ -35688,8 +35768,10 @@ var init_strict_resolver = __esm({
           },
           type: member.type,
           symbol: member,
-          ...member.writability ? {
-            writability: toWritability(member.writability, this.writesUserData)
+          ...writability ? { writability } : {},
+          ...member.lookup ? {
+            entryWritability: this.lookupEntryWritability(member, writability),
+            entryUserData: this.lookupEntryUserData(member)
           } : {}
         };
       }
@@ -35989,7 +36071,7 @@ var init_strict_resolver = __esm({
           const readonlySlot = member.readonlyDeclaration === true;
           const storageWritability = this.memberWritability(member, receiver);
           const writability = readonlySlot ? "readOnly" /* ReadOnly */ : storageWritability;
-          const entryWritability = member.lookup ? this.lookupEntryWritability(member, receiver) : readonlySlot ? storageWritability : void 0;
+          const entryWritability = member.lookup ? this.lookupEntryWritability(member, receiver.writability) : readonlySlot ? storageWritability : void 0;
           const userData = this.memberUserData(member, receiver);
           const entryUserData = member.lookup ? this.lookupEntryUserData(member) : readonlySlot && userData;
           const lookupWire = member.lookup?.multiselect === true && memberType2.kind === "set" ? {
@@ -35999,7 +36081,7 @@ var init_strict_resolver = __esm({
               { ...memberType2.elementType, nullable: false },
               this.project
             ),
-            collectionMemberId: member.lookup.collectionMemberId,
+            ...member.lookup.collectionMemberId !== void 0 ? { collectionMemberId: member.lookup.collectionMemberId } : {},
             ...member.lookup.collectionValueId !== void 0 ? { collectionValueId: member.lookup.collectionValueId } : {}
           } : void 0;
           return {
@@ -36123,16 +36205,18 @@ var init_strict_resolver = __esm({
       }
       lookupEntryUserData(member) {
         if (!member.lookup) return false;
-        const collectionWritability = member.lookup.collectionWritability ?? this.project.symbolById.get(member.lookup.collectionMemberId)?.writability;
+        const collectionMemberId = member.lookup.collectionMemberId;
+        if (collectionMemberId === void 0) return false;
+        const collectionWritability = member.lookup.collectionWritability ?? this.project.symbolById.get(collectionMemberId)?.writability;
         return collectionWritability === "user";
       }
-      lookupEntryWritability(member, receiver) {
+      lookupEntryWritability(member, receiverWritability) {
         if (!member.lookup) return "readOnly" /* ReadOnly */;
-        const target = this.project.symbolById.get(
-          member.lookup.collectionMemberId
-        );
+        const collectionMemberId = member.lookup.collectionMemberId;
+        if (collectionMemberId === void 0) return "runtime" /* Runtime */;
+        const target = this.project.symbolById.get(collectionMemberId);
         const targetWritability = member.lookup.collectionWritability ? toWritability(member.lookup.collectionWritability, this.writesUserData) : target?.writability ? toWritability(target.writability, this.writesUserData) : target?.writable ? "runtime" /* Runtime */ : "readOnly" /* ReadOnly */;
-        if (receiver.writability === "immutable" /* Immutable */) {
+        if (receiverWritability === "immutable" /* Immutable */) {
           if (targetWritability === "save" /* Save */) {
             return "immutableToSaveLookup" /* ImmutableToSaveLookup */;
           }
@@ -46865,6 +46949,8 @@ function matchingDeclaredConstructor(declaration, argumentNames) {
   return neoScriptNamedCallSignature(declaration.constructors, argumentNames) ?? null;
 }
 function semanticType(type) {
+  const read = referenceReadType(type);
+  if (read !== type) return semanticType(read);
   return {
     name: type.name,
     nullable: type.nullable,
@@ -49002,6 +49088,92 @@ var init_project_source_script_compiler = __esm({
   }
 });
 
+// ../packages/neoscript-language/src/project-source-reference-spelling.ts
+function oldReferenceSpelling(member) {
+  if (member.kind !== "field") return null;
+  const settings = member.annotations.find(
+    (entry) => entry.name === "settings"
+  );
+  if (!settings?.arguments.some((entry) => entry.name === "collection")) {
+    return null;
+  }
+  if (referenceReadType(member.type) !== member.type) return null;
+  const spelled = neoSourceTypeText({ ...member.type, nullable: false });
+  const element = member.type.name === "Set" || member.type.name === "List" ? member.type.typeArguments[0] : void 0;
+  const fixed = element === void 0 ? `Reference<${spelled}>` : `Set<Reference<${neoSourceTypeText(element)}>>`;
+  return { settings, spelled, fixed };
+}
+function validateReferenceSpelling(documents, diagnostics) {
+  for (const [uri, document] of documents) {
+    for (const declaration of document.declarations) {
+      if (declaration.kind !== "class") continue;
+      for (const member of declaration.members) {
+        const old = oldReferenceSpelling(member);
+        if (old === null) continue;
+        diagnostics.push({
+          uri,
+          range: member.type.range,
+          severity: "error",
+          source: "neo-project",
+          code: LOOKUP_REFERENCE_SPELLING_CODE,
+          message: `Lookup member ${declaration.name}.${member.name} declares collection: on ${old.spelled}. Spell the type ${old.fixed}.`
+        });
+      }
+    }
+  }
+}
+function projectReferenceSpellingQuickFixes(analysis, document, diagnostic) {
+  if (diagnostic.code !== LOOKUP_REFERENCE_SPELLING_CODE) return [];
+  const source = analysis.documents.get(document.uri);
+  for (const declaration of source?.declarations ?? []) {
+    if (declaration.kind !== "class") continue;
+    for (const member of declaration.members) {
+      if (!sameRange(member.type.range, diagnostic.range)) continue;
+      const old = oldReferenceSpelling(member);
+      if (old === null) return [];
+      const fixed = `${old.fixed}${member.type.nullable ? "?" : ""}`;
+      const edits = [{ range: member.type.range, newText: fixed }];
+      const selection2 = selectionArgumentRange(old.settings);
+      if (selection2 !== null) edits.push({ range: selection2, newText: "" });
+      return [
+        {
+          title: `Change to ${fixed}`,
+          kind: "quickfix",
+          diagnostics: [diagnostic],
+          edit: { changes: { [document.uri]: edits } },
+          preferred: true
+        }
+      ];
+    }
+  }
+  return [];
+}
+function selectionArgumentRange(settings) {
+  const args = settings.arguments;
+  const index = args.findIndex((entry) => entry.name === "selection");
+  if (index < 0) return null;
+  const previous = args[index - 1];
+  if (previous !== void 0) {
+    return { start: previous.range.end, end: args[index].range.end };
+  }
+  const next = args[index + 1];
+  return {
+    start: args[index].range.start,
+    end: next?.range.start ?? args[index].range.end
+  };
+}
+function sameRange(left, right) {
+  return left.start.line === right.start.line && left.start.character === right.start.character && left.end.line === right.end.line && left.end.character === right.end.character;
+}
+var LOOKUP_REFERENCE_SPELLING_CODE;
+var init_project_source_reference_spelling = __esm({
+  "../packages/neoscript-language/src/project-source-reference-spelling.ts"() {
+    "use strict";
+    init_project_source_ast();
+    LOOKUP_REFERENCE_SPELLING_CODE = "lookup-reference-spelling";
+  }
+});
+
 // ../packages/neoscript-language/src/project-source-type-checker.ts
 function validateProjectSourceTypes(documents) {
   const diagnostics = [];
@@ -49012,6 +49184,7 @@ function validateProjectSourceTypes(documents) {
   validateAllTypeApplications(documents, environment, diagnostics);
   validateMembers(environment, diagnostics);
   validateLifecycleHooks(environment, diagnostics);
+  validateReferenceSpelling(documents, diagnostics);
   return diagnostics;
 }
 function createEnvironment2(documents) {
@@ -50703,6 +50876,8 @@ function composeSubstitution(inner, outer) {
   );
 }
 function typeShape2(type, substitution = /* @__PURE__ */ new Map()) {
+  const read = referenceReadType(type);
+  if (read !== type) return typeShape2(read, substitution);
   const replacement = type.typeArguments.length === 0 ? substitution.get(type.name) : void 0;
   if (replacement) {
     return {
@@ -50768,6 +50943,7 @@ var init_project_source_type_checker = __esm({
     "use strict";
     init_language_spec();
     init_project_source_ast();
+    init_project_source_reference_spelling();
     init_lexer();
     init_executable_parser();
     init_strict_compile_error();
@@ -51202,6 +51378,7 @@ function collectDeclarationSymbols(uri, document, declaration, symbols, diagnost
     }
   }
   for (const member of declaration.members) {
+    const readType = referenceReadType(member.type);
     collectSymbol(
       uri,
       "member",
@@ -51212,10 +51389,14 @@ function collectDeclarationSymbols(uri, document, declaration, symbols, diagnost
       symbols,
       diagnostics,
       void 0,
-      member.type.name,
+      readType.name,
       member.kind === "function",
       member.docsText,
-      member.modifiers.includes("static")
+      member.modifiers.includes("static"),
+      readType === member.type ? void 0 : {
+        storage: neoSourceTypeText(member.type),
+        readsAs: neoSourceTypeText(readType)
+      }
     );
     if (member.kind === "function") {
       for (const parameter4 of member.parameters) {
@@ -51313,7 +51494,7 @@ function collectFlowSymbols(uri, content, ownerName, scopeRange, symbols, diagno
     }
   }
 }
-function collectSymbol(uri, kind, name, range2, annotations, ownerName, symbols, diagnostics, scopeRange, detail, callable2, documentation, staticMember) {
+function collectSymbol(uri, kind, name, range2, annotations, ownerName, symbols, diagnostics, scopeRange, detail, callable2, documentation, staticMember, reference2) {
   const memberLabel3 = kind === "member" || kind === "enumOption" || kind === "graphChild";
   const reserved = memberLabel3 ? isNeoProjectMemberReservedName(name) : isNeoProjectReservedName(name);
   if (reserved) {
@@ -51346,6 +51527,7 @@ function collectSymbol(uri, kind, name, range2, annotations, ownerName, symbols,
     ...detail ? { detail } : {},
     ...callable2 ? { callable: callable2 } : {},
     ...staticMember ? { static: true } : {},
+    ...reference2 ? { reference: reference2 } : {},
     ...documentation ? { documentation } : {},
     location: { uri, range: range2 }
   });
@@ -51709,6 +51891,7 @@ var init_project_source_analysis = __esm({
     init_project_local_values();
     init_language_spec();
     init_pending_id();
+    init_project_source_ast();
     init_project_source_identifiers();
     init_project_source_parser();
     init_project_source_registry();
@@ -52940,7 +53123,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.76.3",
+      cliVersion: "0.77.0",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -54800,6 +54983,39 @@ var init_dialogue_source_names = __esm({
 });
 
 // src/project-source/key-reference-spelling.ts
+function parseIndexPathSpellingV4(expression) {
+  const indexed = expression.kind === "force" ? expression.operand : expression;
+  if (indexed.kind !== "index" || indexed.optional === true) return null;
+  if (indexed.index.kind !== "litString") return null;
+  const indexName = indexed.receiver;
+  if (indexName.kind !== "member" || indexName.optional === true) return null;
+  const marker = indexName.receiver;
+  if (marker.kind !== "member" || marker.optional === true) return null;
+  if (marker.name !== "Index") return null;
+  const listPath = rootMemberPath(marker.receiver);
+  if (listPath === null) return null;
+  return {
+    spelling: "indexPath",
+    listPath,
+    indexSchemaKey: indexName.name,
+    key: indexed.index.value
+  };
+}
+function rootMemberPath(expression) {
+  const segments = [];
+  let current = expression;
+  while (current.kind === "member") {
+    if (current.optional === true) return null;
+    segments.unshift(current.name);
+    current = current.receiver;
+  }
+  if (current.kind !== "ident" || current.name !== "root") return null;
+  if (segments.length === 0) return null;
+  return `root.${segments.join(".")}`;
+}
+function indexPathSourceV4(spelling) {
+  return `${spelling.listPath}.Index.${spelling.indexSchemaKey}[${JSON.stringify(spelling.key)}]`;
+}
 function referenceCallNamesKeyV4(expression) {
   if (expression.kind !== "call") return false;
   return expression.argumentNames?.some((name) => name === "key") ?? false;
@@ -54840,11 +55056,7 @@ function astTypeNameV4(type) {
   return "Dictionary";
 }
 function encodeMemberDefaultKeyReferenceV4(spelling) {
-  return `${MEMBER_DEFAULT_KEY_PENDING_PREFIX}${JSON.stringify({
-    key: spelling.key,
-    indexSchemaKey: spelling.indexSchemaKey,
-    typeName: spelling.typeName
-  })}`;
+  return `${MEMBER_DEFAULT_KEY_PENDING_PREFIX}${JSON.stringify(spelling)}`;
 }
 function isMemberDefaultKeyPlaceholderV4(value) {
   return typeof value === "string" && value.startsWith(MEMBER_DEFAULT_KEY_PENDING_PREFIX);
@@ -54856,6 +55068,16 @@ function decodeMemberDefaultKeyReferenceV4(encoded) {
   );
   if (!isObjectRecord2(payload)) return null;
   if (typeof payload.key !== "string") return null;
+  if (payload.spelling === "indexPath") {
+    if (typeof payload.listPath !== "string") return null;
+    if (typeof payload.indexSchemaKey !== "string") return null;
+    return {
+      spelling: "indexPath",
+      listPath: payload.listPath,
+      indexSchemaKey: payload.indexSchemaKey,
+      key: payload.key
+    };
+  }
   if (typeof payload.typeName !== "string") return null;
   if (payload.indexSchemaKey !== null && typeof payload.indexSchemaKey !== "string") {
     return null;
@@ -54867,19 +55089,16 @@ function decodeMemberDefaultKeyReferenceV4(encoded) {
     typeName: payload.typeName
   };
 }
-function memberDefaultKeyPlaceholderInBodyV4(body) {
-  if (isMemberDefaultKeyPlaceholderV4(body)) return body;
-  if (!Array.isArray(body)) return null;
-  for (const entry of body) {
-    if (isMemberDefaultKeyPlaceholderV4(entry)) return entry;
-  }
-  return null;
+function memberDefaultKeyPlaceholdersInBodyV4(body) {
+  if (isMemberDefaultKeyPlaceholderV4(body)) return [body];
+  if (!Array.isArray(body)) return [];
+  return body.filter(isMemberDefaultKeyPlaceholderV4);
 }
-function substituteMemberDefaultKeyReferenceV4(body, targetId) {
-  if (isMemberDefaultKeyPlaceholderV4(body)) return targetId;
+function substituteMemberDefaultKeyReferenceV4(body, resolved) {
+  if (isMemberDefaultKeyPlaceholderV4(body)) return resolved.get(body) ?? body;
   if (!Array.isArray(body)) return body;
   return body.map(
-    (entry) => isMemberDefaultKeyPlaceholderV4(entry) ? targetId : entry
+    (entry) => isMemberDefaultKeyPlaceholderV4(entry) ? resolved.get(entry) ?? entry : entry
   );
 }
 var MEMBER_DEFAULT_KEY_PENDING_PREFIX;
@@ -57051,12 +57270,23 @@ var init_schema_member = __esm({
         enumId: nonEmptyString,
         multiselect: boolean()
       }),
-      memberSchema("lookup", {
-        collectionMemberId: nonEmptyString,
-        collectionValueId: nullableId,
-        multiselect: boolean(),
-        declaredType: nullable(schemaTypeSchema)
-      }),
+      pipe(
+        memberSchema("lookup", {
+          /** `null` on an unbound `Reference<T>` (P107), typed by `declaredType`. */
+          collectionMemberId: nullable(nonEmptyString),
+          collectionValueId: nullableId,
+          multiselect: boolean(),
+          declaredType: nullable(schemaTypeSchema)
+        }),
+        check(
+          (member) => member.collectionMemberId !== null || member.collectionValueId === null,
+          "A lookup collection value requires a collection member."
+        ),
+        check(
+          (member) => member.collectionMemberId !== null || member.declaredType?.kind === "class" || member.declaredType?.kind === "generic",
+          "A lookup without a collection needs a class or generic declared type."
+        )
+      ),
       memberSchema("dialogueLookup", {
         dialogueGroupId: nullableId,
         multiselect: boolean()
@@ -57492,10 +57722,8 @@ function memberFromDocument(record7, members, owners, classNames, context) {
     return {
       ...common,
       kind: "lookup",
-      collectionMemberId: requiredStringValue(
-        field("collectionMemberId", void 0),
-        record7,
-        "collectionMemberId"
+      collectionMemberId: optionalStringOrNull(
+        field("collectionMemberId", null)
       ),
       collectionValueId: optionalStringOrNull(field("collectionValueId", null)),
       multiselect: ordinalValue(
@@ -57793,7 +58021,9 @@ function memberToDocumentFields(member, baseData3) {
     }
   }
   if (member.kind === "lookup") {
-    fields.collectionMemberId = member.collectionMemberId;
+    if (member.collectionMemberId !== null) {
+      fields.collectionMemberId = member.collectionMemberId;
+    }
     if (member.collectionValueId !== null) {
       fields.collectionValueId = member.collectionValueId;
     }
@@ -66035,17 +66265,21 @@ var init_neoscript_source_catalog = __esm({
 
 // ../packages/models/src/members/lookup-declared-type.ts
 function lookupDeclaredTypeInfo2(member, collectionTypeInfo) {
-  if (collectionTypeInfo === null) return null;
-  if (collectionTypeInfo.type !== 6 /* List */ && collectionTypeInfo.type !== 5 /* Dictionary */) {
-    return null;
-  }
-  const entryTypeInfo = member.declaredTypeInfo ?? collectionTypeInfo.entryTypeInfo;
+  const entryTypeInfo = lookupEntryTypeInfo(member, collectionTypeInfo);
+  if (entryTypeInfo === null) return null;
   if (isMultiSelectionMember(member) !== true) {
     return {
       ...entryTypeInfo,
       required: isRequiredMember(member)
     };
   }
+  if (member.collectionMemberId === void 0) {
+    return {
+      type: 9 /* Lookup */,
+      required: isRequiredMember(member),
+      entryTypeInfo
+    };
+  }
   return {
     type: 9 /* Lookup */,
     required: isRequiredMember(member),
@@ -66054,6 +66288,15 @@ function lookupDeclaredTypeInfo2(member, collectionTypeInfo) {
     collectionValueId: member.collectionValueId ?? null
   };
 }
+function lookupEntryTypeInfo(member, collectionTypeInfo) {
+  if (member.collectionMemberId === void 0) return member.declaredTypeInfo;
+  const collection = collectionTypeInfo(member.collectionMemberId);
+  if (collection === null) return null;
+  if (collection.type !== 6 /* List */ && collection.type !== 5 /* Dictionary */) {
+    return null;
+  }
+  return member.declaredTypeInfo ?? collection.entryTypeInfo;
+}
 var init_lookup_declared_type = __esm({
   "../packages/models/src/members/lookup-declared-type.ts"() {
     "use strict";
@@ -66167,19 +66410,18 @@ function resolveMemberDeclaredTypeInfoInternal(member, members, seen, ownerClass
     };
   }
   if (isMemberLookupBase(resolved)) {
-    const collection = members.find(
-      (candidate) => candidate.id === resolved.collectionMemberId
-    );
-    if (collection === void 0) return null;
-    return lookupDeclaredTypeInfo2(
-      resolved,
-      resolveMemberDeclaredTypeInfoInternal(
+    return lookupDeclaredTypeInfo2(resolved, (collectionMemberId) => {
+      const collection = members.find(
+        (candidate) => candidate.id === collectionMemberId
+      );
+      if (collection === void 0) return null;
+      return resolveMemberDeclaredTypeInfoInternal(
         collection,
         members,
         nextSeen,
         ownerClass
-      )
-    );
+      );
+    });
   }
   if (resolved.kind === 9 /* Lookup */) return null;
   if (!memberKindSupportsStorage(resolved.kind)) return null;
@@ -66748,12 +66990,10 @@ function memberSymbol(member, schemaKey, environment, field) {
       environment
     );
   }
-  const lookupCollectionMemberId = kind === "lookup" ? string3(member.collectionMemberId, `${field}.collectionMemberId`) : null;
-  const lookupCollectionWritability = lookupCollectionMemberId === null ? void 0 : environment.effectiveWritabilityByMemberId.get(
-    lookupCollectionMemberId
-  );
+  const lookupCollection = kind === "lookup" ? lookupCollectionMemberId(member, field) : null;
+  const lookupCollectionWritability = lookupCollection === null ? void 0 : environment.effectiveWritabilityByMemberId.get(lookupCollection);
   const lookup = kind === "lookup" ? {
-    collectionMemberId: lookupCollectionMemberId,
+    ...lookupCollection === null ? {} : { collectionMemberId: lookupCollection },
     ...member.collectionValueId === null || typeof member.collectionValueId === "string" ? { collectionValueId: member.collectionValueId } : {},
     multiselect: boolean2(member.multiselect, `${field}.multiselect`),
     ...lookupCollectionWritability === void 0 ? {} : { collectionWritability: lookupCollectionWritability }
@@ -66767,6 +67007,10 @@ function memberSymbol(member, schemaKey, environment, field) {
     ...lookup ? { lookup } : {}
   };
 }
+function lookupCollectionMemberId(member, field) {
+  if (member.collectionMemberId === null) return null;
+  return string3(member.collectionMemberId, `${field}.collectionMemberId`);
+}
 function interfaceType(value, environment, field) {
   const id2 = string3(value.id, `${field}.id`);
   return {
@@ -67235,9 +67479,8 @@ function memberType(member, environment, visiting, field) {
     };
   }
   if (kind === "lookup") {
-    const collection = environment.members.get(
-      string3(member.collectionMemberId, `${field}.collectionMemberId`)
-    );
+    const collectionMemberId = lookupCollectionMemberId(member, field);
+    const collection = collectionMemberId === null ? void 0 : environment.members.get(collectionMemberId);
     const collectionType = collection ? memberType(collection, environment, next, `${field}.collection`) : unknownType();
     const declared = optionalRecord(member.declaredType);
     const declaredType = declared ? manifestType2(declared, environment, `${field}.declaredType`) : null;
@@ -68640,6 +68883,13 @@ function memberToSymbol(record7, schemaKey, containingClass2, ownerClassId, inde
     };
   }
   if (isMemberLookupBase(resolved)) {
+    if (resolved.collectionMemberId === void 0) {
+      return {
+        ...common,
+        kind: "property",
+        lookup: { multiselect: isMultiSelectionMember(resolved) }
+      };
+    }
     const collectionWritability = uniqueEffectiveWritability(
       resolved.collectionMemberId,
       context
@@ -68995,12 +69245,12 @@ function memberRuntimeType(record7, context, seen = /* @__PURE__ */ new Set(), g
       if (!isMemberLookupBase(member)) return UNKNOWN_TYPE2;
       const declared = member.declaredTypeInfo ? toLanguageType(member.declaredTypeInfo, context, genericEnvironment) : null;
       const narrowed = declared && !isUnknownType3(declared) ? declared : null;
-      const entry = narrowed ?? lookupCollectionEntryType(
+      const entry = narrowed ?? (member.collectionMemberId === void 0 ? null : lookupCollectionEntryType(
         member.collectionMemberId,
         context,
         nextSeen,
         genericEnvironment
-      );
+      ));
       if (!entry) return UNKNOWN_TYPE2;
       return isMultiSelectionMember(member) ? {
         kind: "set",
@@ -70840,6 +71090,7 @@ function inferChildMemberFromParentValue(parent, parentMember, data) {
     return findMemberById(parentMember.entryMemberId, data.members);
   }
   if (isMemberLookupBase(parentMember)) {
+    if (parentMember.collectionMemberId === void 0) return null;
     const collectionMember = findMemberById(
       parentMember.collectionMemberId,
       data.members
@@ -75845,7 +76096,11 @@ function evalInstructions(instructions, scope, ctx, options) {
           }
           let targetTypeInfo = ins.target.typeInfo;
           if (lookupAssignment && targetTypeInfo.type !== 9 /* Lookup */ && targetTypeInfo.type !== 18 /* DialogueLookup */) {
-            targetTypeInfo = {
+            targetTypeInfo = member.collectionMemberId === void 0 ? {
+              type: 9 /* Lookup */,
+              required: targetTypeInfo.required,
+              entryTypeInfo: targetTypeInfo
+            } : {
               type: 9 /* Lookup */,
               required: targetTypeInfo.required,
               entryTypeInfo: targetTypeInfo,
@@ -78539,6 +78794,13 @@ function runtimeTypeInfoForMember(rawMember, env, ctx, seen) {
     };
   }
   if (isMemberLookup(member)) {
+    if (member.collectionMemberId === void 0) {
+      const entryTypeInfo2 = {
+        ...substituteRuntimeTypeInfo(member.declaredTypeInfo, env, ctx),
+        required: isMultiSelectionMember(member) ? true : false
+      };
+      return isMultiSelectionMember(member) ? { type: 9 /* Lookup */, required: required2, entryTypeInfo: entryTypeInfo2 } : entryTypeInfo2;
+    }
     const collection = evalMemberById(ctx.vm, member.collectionMemberId);
     if (collection === null) {
       throw new NSGetterRuntimeError(
@@ -94755,7 +95017,16 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
   const storedStatic = declaration.modifiers.includes("static");
   const settings = annotation(declaration.annotations, "settings");
   const inherited = inheritedMember(context, commonInput.overrideOf);
-  const storesSelectionArray = context.enumIdsByName.has(fieldType.name) || fieldType.name === "NeoDialogueReference" || Boolean(settings && argument(settings, "collection"));
+  const reference2 = referenceMemberShape(fieldType);
+  const collectionArgument = argument(settings, "collection");
+  if (reference2 === null && collectionArgument !== null) {
+    const spelled = formatManifestType({ ...fieldType, nullable: false });
+    const fixed = (fieldType.name === "Set" || fieldType.name === "List") && fieldType.arguments[0] !== void 0 ? `Set<Reference<${formatManifestType(fieldType.arguments[0])}>>` : `Reference<${spelled}>`;
+    throw new Error(
+      `Lookup member ${ownerClass.name}.${declaration.name} declares collection: on ${spelled}. Spell the type ${fixed}.`
+    );
+  }
+  const storesSelectionArray = context.enumIdsByName.has(fieldType.name) || fieldType.name === "NeoDialogueReference" || reference2 !== null;
   const common = {
     ...commonInput,
     // A stored static initializer authors the live value binding, never an
@@ -94764,13 +95035,14 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
     defaultValue: storedStatic ? base?.defaultValue ?? null : lowerDefault(
       context,
       declaration.initializer,
-      declaration.type,
+      reference2?.readType ?? declaration.type,
       ownerClass,
       base,
       id2,
       storesSelectionArray,
       `${ownerClass.name}.${declaration.name}`,
-      !declaration.modifiers.includes("static") && contextualEnumArgument(settings, "kind") === "Unordered"
+      !declaration.modifiers.includes("static") && contextualEnumArgument(settings, "kind") === "Unordered",
+      reference2 !== null
     )
   };
   const name = fieldType.name;
@@ -94899,39 +95171,56 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
     };
   }
   if (primitive3) return { ...common, kind: primitive3 };
-  if (settings && argument(settings, "collection")) {
-    const collectionMemberId = resolveQualifiedMemberId(context, argument(settings, "collection")) ?? (base?.kind === "lookup" ? base.collectionMemberId : null);
-    if (!collectionMemberId) {
+  if (reference2 !== null) {
+    if (argument(settings, "selection") !== null) {
+      throw new Error(
+        `Lookup member ${ownerClass.name}.${declaration.name} declares selection:. Reference<T> selects one row and Set<Reference<T>> selects many, so remove selection:.`
+      );
+    }
+    assertNoElementSettings(fieldType, ownerClass, declaration, "lookup");
+    const inheritedCollectionMemberId = inherited?.kind === "lookup" ? inherited.collectionMemberId : null;
+    if (collectionArgument === null && inheritedCollectionMemberId !== null) {
+      throw new Error(
+        `Lookup member ${ownerClass.name}.${declaration.name} overrides a lookup bound to ${storageChainStep(context, inheritedCollectionMemberId)?.label ?? inheritedCollectionMemberId}. An override cannot drop its collection; add @settings(collection: ...).`
+      );
+    }
+    const collectionMemberId = collectionArgument === null ? null : resolveQualifiedMemberId(context, collectionArgument) ?? (base?.kind === "lookup" ? base.collectionMemberId : null);
+    if (collectionArgument === null && argument(settings, "collectionValue") !== null) {
+      throw new Error(
+        `Lookup member ${ownerClass.name}.${declaration.name} declares collectionValue: without collection:. Add the collection it searches, or remove collectionValue:.`
+      );
+    }
+    if (collectionArgument !== null && collectionMemberId === null) {
       throw new Error(
         `Lookup member ${ownerClass.name}.${declaration.name} has an unresolved collection.`
       );
     }
-    const selection2 = contextualEnumArgument(settings, "selection");
-    if (fieldType.name === "Set" && selection2 === "Single") {
+    const declaredType = lookupDeclaredType(
+      context,
+      ownerClass,
+      reference2.target
+    );
+    if (collectionMemberId === null && declaredType?.kind === "interface") {
       throw new Error(
-        `Lookup member ${ownerClass.name}.${declaration.name} declares Set<T> but explicitly selects .Single. Use the element type for a single selection or remove selection: .Single.`
+        `Lookup member ${ownerClass.name}.${declaration.name} targets interface ${reference2.target.name}. Reference<T> needs a class or generic parameter.`
+      );
+    }
+    if (collectionMemberId === null && declaredType === null) {
+      throw new Error(
+        `Lookup member ${ownerClass.name}.${declaration.name} targets ${formatManifestType(reference2.target)}. Reference<T> needs a class or generic parameter.`
       );
     }
-    const multiselect = fieldType.name === "Set" || selection2 === "Multi";
-    assertNoElementSettings(fieldType, ownerClass, declaration, "lookup");
     return {
       ...common,
       kind: "lookup",
       collectionMemberId,
       collectionValueId: referenceIdArgument(settings, "collectionValue"),
-      multiselect,
-      // The spelled type, kept only when it narrows the collection entry —
-      // `normalizeLookupDeclaredTypes` clears the redundant ones once every
-      // member is lowered and the entry can be resolved in either direction.
-      declaredType: lookupDeclaredType(
-        context,
-        ownerClass,
-        // A multiselect lookup is spelled `Set<T>` and stores the element
-        // type, which is what the emitter re-wraps. Keyed off the spelling
-        // rather than off `multiselect` so a mismatched pair reads the type it
-        // actually has instead of throwing for a missing type argument.
-        fieldType.name === "List" || fieldType.name === "Set" ? requiredTypeArgument(fieldType, 0) : fieldType
-      )
+      multiselect: reference2.multiselect,
+      // The spelled type. A bound lookup keeps it only when it narrows the
+      // collection entry -- `normalizeLookupDeclaredTypes` clears the redundant
+      // ones once every member is lowered. An unbound lookup always keeps it:
+      // it is the only target type the member has.
+      declaredType
     };
   }
   if (name === "List" || name === "Set") {
@@ -95183,6 +95472,10 @@ function overrideParentMemberId(context, memberId) {
   return overrides ? inheritedMemberId(context, ownerClass, member.name) : null;
 }
 function lowerCollectionEntry(context, ownerClass, entryType, entryId, parentMemberId, declaringMemberId, entrySettings) {
+  const reference2 = referenceMemberShape(entryType);
+  if (reference2 !== null) {
+    throw referenceStorageTypeError(reference2.target);
+  }
   const declared = declaredCollectionEntryType(context, declaringMemberId);
   const expected = declared === null ? null : resolveManifestTypeInDescendant(
     context,
@@ -95486,6 +95779,30 @@ function lowerEnum(context, declaration) {
     system: systemMetadata(declaration.annotations) ?? base?.system ?? null
   };
 }
+function referenceStorageTypeError(referenced) {
+  const target = formatManifestType(referenced);
+  return new Error(
+    `Reference<${target}> is a member storage type. Write ${target} here.`
+  );
+}
+function referenceMemberShape(type) {
+  if (type.name === "Reference") {
+    const target2 = requiredTypeArgument(type, 0);
+    return {
+      target: target2,
+      multiselect: false,
+      readType: { ...target2, nullable: type.nullable }
+    };
+  }
+  const element = type.name === "Set" ? type.arguments[0] : void 0;
+  if (element?.name !== "Reference") return null;
+  const target = requiredTypeArgument(element, 0);
+  return {
+    target,
+    multiselect: true,
+    readType: { ...type, arguments: [target] }
+  };
+}
 function lookupDeclaredType(context, ownerClass, type) {
   if (type.name === "object") return null;
   const lowered = lowerType(context, type, ownerClass);
@@ -95498,6 +95815,7 @@ function normalizeLookupDeclaredTypes(context) {
   for (const [memberId, member] of context.loweredMembers) {
     if (member.kind !== "lookup") continue;
     if (member.declaredType === null) continue;
+    if (member.collectionMemberId === null) continue;
     if (!lookupDeclaredTypeNarrows(context, member)) {
       context.loweredMembers.set(memberId, { ...member, declaredType: null });
     }
@@ -95506,6 +95824,7 @@ function normalizeLookupDeclaredTypes(context) {
 function lookupDeclaredTypeNarrows(context, member) {
   const declared = member.declaredType;
   if (declared === null) return false;
+  if (member.collectionMemberId === null) return true;
   const entry = lookupEntryMember(context, member.collectionMemberId);
   if (entry === void 0) return false;
   if (entry.kind === "class") {
@@ -95531,6 +95850,9 @@ function lowerType(context, type, ownerClass) {
   if (type.name === "void") {
     throw new Error("void is valid only as a function return type.");
   }
+  if (type.name === "Reference") {
+    throw referenceStorageTypeError(requiredTypeArgument(type, 0));
+  }
   if (type.name === "Set") {
     return {
       kind: "lookup",
@@ -95628,7 +95950,18 @@ function lowerType(context, type, ownerClass) {
   if (type.name === "object") return { kind: "unknown", nullable: nullable2 };
   throw new Error(`Unknown Neo type ${JSON.stringify(type.name)}.`);
 }
-function lowerDefault(context, initializer, type, ownerClass, base, memberId, storesSelectionArray, path, unorderedList = false) {
+function indexPathDefault(expression) {
+  const elements = expression.kind === "litList" ? expression.elements : [expression];
+  if (elements.length === 0) return null;
+  const placeholders = [];
+  for (const element of elements) {
+    const spelling = parseIndexPathSpellingV4(element);
+    if (spelling === null) return null;
+    placeholders.push(encodeMemberDefaultKeyReferenceV4(spelling));
+  }
+  return placeholders;
+}
+function lowerDefault(context, initializer, type, ownerClass, base, memberId, storesSelectionArray, path, unorderedList = false, reference2 = false) {
   if (initializer === null) {
     return base?.defaultValue && "serverValueId" in base.defaultValue ? base.defaultValue : null;
   }
@@ -95650,6 +95983,8 @@ function lowerDefault(context, initializer, type, ownerClass, base, memberId, st
   }
   if (base?.defaultValue != null && matchesStoredInitializer(base.defaultValue, initializer))
     return base.defaultValue;
+  const indexPaths = reference2 ? indexPathDefault(expression) : null;
+  if (indexPaths !== null) return { value: indexPaths, classId: null };
   if (unorderedList && expression.kind === "litList" && expression.elements.length > 0 || positionRequiresEvaluation(context, expression, type, ownerClass)) {
     return {
       init: {
@@ -96014,7 +96349,8 @@ function lowerExpressionValue(context, expression, declaredExpected, ownerClass,
         );
         const member = memberId !== null ? context.loweredMembers.get(memberId) ?? context.baseMembers.get(memberId) : void 0;
         const sourceMember = memberId !== null ? context.sourceMembersById.get(memberId)?.member : void 0;
-        const declaredType = sourceMember?.type ?? (member ? manifestTypeForMember(context, member) : { name: "object", nullable: true, arguments: [] });
+        const sourceType = sourceMember === void 0 ? void 0 : referenceMemberShape(sourceMember.type)?.readType ?? sourceMember.type;
+        const declaredType = sourceType ?? (member ? manifestTypeForMember(context, member) : { name: "object", nullable: true, arguments: [] });
         result[assignment.name] = lowerExpressionValue(
           context,
           assignment.value,
@@ -97398,6 +97734,7 @@ function emitProjectSourcesV4(manifest, options = {}) {
     collectionValuePaths: options.collectionValuePaths ?? /* @__PURE__ */ new Map(),
     variantPathsById: buildVariantPathsByIdV4(manifest),
     formAlternates: [],
+    ...options.referenceTargetSource === void 0 ? {} : { referenceTargetSource: options.referenceTargetSource },
     templateNames: new Map(
       [...manifest.textureTemplates, ...manifest.audioTemplates].map(
         (template) => [template.id, template.name]
@@ -98034,7 +98371,7 @@ function memberSettings(context, member) {
     if (member.listKind === "unordered") settings.push("kind: .Unordered");
   } else if (member.kind === "enum" && member.multiselect) {
     settings.push("selection: .Multi");
-  } else if (member.kind === "lookup") {
+  } else if (member.kind === "lookup" && member.collectionMemberId !== null) {
     settings.push(
       `collection: ${qualifiedMember(context, member.collectionMemberId)}`
     );
@@ -98046,7 +98383,6 @@ function memberSettings(context, member) {
         rootPath === void 0 ? `collectionValue: Reference(id: ${quote(member.collectionValueId)})` : `collectionValue: Reference(${rootPath})`
       );
     }
-    if (member.multiselect) settings.push("selection: .Multi");
   } else if (member.kind === "dialogueLookup") {
     if (member.dialogueGroupId) {
       settings.push(
@@ -98196,7 +98532,7 @@ function renderMemberType(context, member, enclosingClassId, elementSettings = f
       break;
     }
     case "lookup": {
-      const target = member.declaredType === null ? renderLookupEntryType(context, member.collectionMemberId) : renderType(context, member.declaredType).replace(/\?$/u, "");
+      const target = `Reference<${renderLookupTargetType(context, member)}>`;
       value = member.multiselect ? `Set<${target}>` : target;
       break;
     }
@@ -98248,6 +98584,17 @@ function renderActionType(argumentTypes) {
   if (argumentTypes.length === 0) return "NeoAction";
   return `NeoAction<${argumentTypes.join(", ")}>`;
 }
+function renderLookupTargetType(context, member) {
+  if (member.declaredType !== null) {
+    return renderType(context, member.declaredType).replace(/\?$/u, "");
+  }
+  if (member.collectionMemberId === null) {
+    throw new Error(
+      `Lookup member ${member.name} has neither a collection nor a declared type.`
+    );
+  }
+  return renderLookupEntryType(context, member.collectionMemberId);
+}
 function renderLookupEntryType(context, collectionMemberId) {
   const collection = required(
     context.members,
@@ -98565,9 +98912,10 @@ function renderDefaultValue(context, member, wrapper, enclosingClassId) {
     ).name;
   }
   if ((member.kind === "lookup" || member.kind === "dialogueLookup") && Array.isArray(value)) {
-    const renderedType = referenceTargetType(context, member, enclosingClassId);
-    const targetType = member.multiselect ? /^Set<(.+)>$/u.exec(renderedType)?.[1] ?? renderedType : renderedType;
-    const refs = value.filter((entry) => typeof entry === "string").map((entry) => `Reference<${targetType}>(id: ${quote(entry)})`);
+    const targetType = referenceTargetType(context, member, enclosingClassId);
+    const refs = value.filter((entry) => typeof entry === "string").map(
+      (entry) => unboundReferenceSource(context, member, entry) ?? `Reference<${targetType}>(id: ${quote(entry)})`
+    );
     if (refs.length === 0 && value.length === 0) return "[]";
     return member.multiselect ? `[${refs.join(", ")}]` : refs[0] ?? "null";
   }
@@ -98620,8 +98968,15 @@ function renderDefaultValue(context, member, wrapper, enclosingClassId) {
 function spriteFileSource(context, fileId) {
   return context.fileSymbols.get(fileId) ?? `Reference<NeoImage>(id: ${quote(fileId)})`;
 }
+function unboundReferenceSource(context, member, targetId) {
+  if (member.kind !== "lookup" || member.collectionMemberId !== null) {
+    return null;
+  }
+  return context.referenceTargetSource?.(member, targetId) ?? null;
+}
 function referenceTargetType(context, member, enclosingClassId) {
   if (member.kind === "dialogueLookup") return "NeoDialogue";
+  if (member.kind === "lookup") return renderLookupTargetType(context, member);
   return renderMemberType(context, member, enclosingClassId).replace(
     /\?$/u,
     ""
@@ -98639,7 +98994,7 @@ function renderNestedValue(context, member, value, enclosingClassId) {
       );
       if (option !== void 0) return `.${option.name}`;
     }
-    return `Reference<${referenceTargetType(context, member, enclosingClassId)}>(id: ${quote(value)})`;
+    return unboundReferenceSource(context, member, value) ?? `Reference<${referenceTargetType(context, member, enclosingClassId)}>(id: ${quote(value)})`;
   }
   return renderDefaultValue(
     context,
@@ -105146,6 +105501,8 @@ function validateProjectRecordByKind(recordKind, data, options = {}) {
   if (recordKind === ProjectRecordKind.Member) {
     const memberGuard = options.members === "authored-or-compiled" ? isAnyMemberAuthoredOrCompiled : isAnyMember;
     if (memberGuard(data)) return;
+    const lookupViolation = lookupShapeViolation(data);
+    if (lookupViolation !== null) throw new Error(lookupViolation);
     const unrounded = unroundedFloatPath(data);
     if (unrounded !== null) {
       const id2 = typeof data === "object" && data !== null && "id" in data ? String(data.id) : "";
@@ -105236,6 +105593,7 @@ var init_project_record_validation = __esm({
     init_project();
     init_variants();
     init_members();
+    init_member_kinds();
     init_classes();
     init_constructors2();
     init_packed_value_record_validation();
@@ -109802,22 +110160,31 @@ function lookupTargetClassContractViolation(args) {
   if (actualClassId === null) return null;
   const classById = args.schemaIndex.classesById;
   if (!classById.has(actualClassId)) return null;
+  const collectionMemberId = args.member.collectionMemberId;
+  if (collectionMemberId === void 0) {
+    const target = args.member.declaredTypeInfo;
+    const targetClassId = target.type === 7 /* Class */ ? target.classId : genericParamClassConstraintId(target, classById);
+    if (targetClassId === null) return null;
+    if (args.schemaIndex.classIsOrExtends(actualClassId, targetClassId))
+      return null;
+    return `lookup member ${args.member.name} target ${args.targetValueId} is ${classDisplayName(actualClassId, classById)}, but the member declares ${classDisplayName(targetClassId, classById)}. Point it at a ${classDisplayName(targetClassId, classById)} row.`;
+  }
+  const declaredClassId = lookupDeclaredClassId(args.member, classById);
   const entryClassId = lookupEntryClassId(
-    args.member,
+    collectionMemberId,
     args.schemaIndex.membersById
   );
   if (entryClassId !== null && classById.has(entryClassId) && !args.schemaIndex.classIsOrExtends(actualClassId, entryClassId)) {
-    return `lookup member ${args.member.name} target ${args.targetValueId} is ${classDisplayName(actualClassId, classById)}, but collection ${collectionMemberName(args.member, args.schemaIndex)} holds ${classDisplayName(entryClassId, classById)}.`;
+    return `lookup member ${args.member.name} target ${args.targetValueId} is ${classDisplayName(actualClassId, classById)}, but collection ${collectionMemberName(collectionMemberId, args.schemaIndex)} holds ${classDisplayName(entryClassId, classById)}.`;
   }
-  const declaredClassId = lookupDeclaredClassId(args.member, classById);
   if (declaredClassId !== null && !args.schemaIndex.classIsOrExtends(actualClassId, declaredClassId)) {
-    const narrowedFrom = entryClassId === null || !classById.has(entryClassId) ? `the collection ${collectionMemberName(args.member, args.schemaIndex)}` : `the collection ${collectionMemberName(args.member, args.schemaIndex)} holds ${classDisplayName(entryClassId, classById)}`;
+    const narrowedFrom = entryClassId === null || !classById.has(entryClassId) ? `the collection ${collectionMemberName(collectionMemberId, args.schemaIndex)}` : `the collection ${collectionMemberName(collectionMemberId, args.schemaIndex)} holds ${classDisplayName(entryClassId, classById)}`;
     return `lookup member ${args.member.name} target ${args.targetValueId} is ${classDisplayName(actualClassId, classById)}, but the member declares ${classDisplayName(declaredClassId, classById)} \u2014 ${narrowedFrom} and this member narrows it. Point it at a ${classDisplayName(declaredClassId, classById)} row.`;
   }
   return null;
 }
-function lookupEntryClassId(member, memberById2) {
-  const collection = memberById2.get(member.collectionMemberId);
+function lookupEntryClassId(collectionMemberId, memberById2) {
+  const collection = memberById2.get(collectionMemberId);
   if (collection === void 0) return null;
   if (!isMemberListBase(collection) && !isMemberDictionaryBase(collection)) {
     return null;
@@ -109836,24 +110203,45 @@ function lookupDeclaredClassId(member, classById) {
 function classDisplayName(classId, classById) {
   return classById.get(classId)?.name ?? classId;
 }
-function collectionMemberName(member, schemaIndex) {
-  const collection = schemaIndex.membersById.get(member.collectionMemberId);
-  if (collection === void 0) return member.collectionMemberId;
+function collectionMemberName(collectionMemberId, schemaIndex) {
+  const collection = schemaIndex.membersById.get(collectionMemberId);
+  if (collection === void 0) return collectionMemberId;
   const owner = schemaIndex.schemaPlacementsByMemberId.get(collection.id)?.[0]?.ownerClass;
   return owner ? `${owner.name}.${collection.name}` : collection.name;
 }
 function lookupDeclaredClassContractViolation(member, schemaIndex) {
+  if (member.collectionMemberId === void 0) {
+    return unboundLookupTargetViolation(member, schemaIndex);
+  }
   const declared = lookupDeclaredClassId(member, schemaIndex.classesById);
-  const entry = lookupEntryClassId(member, schemaIndex.membersById);
+  const entry = lookupEntryClassId(
+    member.collectionMemberId,
+    schemaIndex.membersById
+  );
   if (declared === null || entry === null || !schemaIndex.classesById.has(entry))
     return null;
   if (schemaIndex.classIsOrExtends(declared, entry)) return null;
-  return `Lookup member ${member.name} declares ${classDisplayName(declared, schemaIndex.classesById)}, but collection ${collectionMemberName(member, schemaIndex)} holds ${classDisplayName(entry, schemaIndex.classesById)}.`;
+  return `Lookup member ${member.name} declares ${classDisplayName(declared, schemaIndex.classesById)}, but collection ${collectionMemberName(member.collectionMemberId, schemaIndex)} holds ${classDisplayName(entry, schemaIndex.classesById)}.`;
+}
+function unboundLookupTargetViolation(member, schemaIndex) {
+  const target = member.declaredTypeInfo;
+  if (target.type === 7 /* Class */) {
+    if (schemaIndex.classesById.has(target.classId)) return null;
+    return `Lookup member ${member.name} references class ${target.classId}, which does not exist.`;
+  }
+  const scoped = schemaIndex.schemaPlacements(member.id).some(
+    (placement) => resolveGenericScope(placement.ownerClass.id, schemaIndex.classes).some(
+      (entry) => entry.param.id === target.genericParamId
+    )
+  );
+  if (scoped) return null;
+  return `Lookup member ${member.name} references generic parameter ${target.genericParamId}, which is not in scope on its declaring class.`;
 }
 var init_lookup_target_class_contract = __esm({
   "../src/database/lookup-target-class-contract.ts"() {
     "use strict";
     init_member_kinds();
+    init_generics();
   }
 });
 
@@ -120959,6 +121347,14 @@ function assertProjectInterfaceDocumentValid(view, options = {}) {
         ...resolved.kind === 5 && resolved.keyEnumId ? { keyEnumId: resolved.keyEnumId } : {}
       };
     }
+    if (resolved.kind === 9 && resolved.collectionMemberId === void 0) {
+      const entryTypeInfo = substituteTypeInfoForClass(
+        resolved.declaredTypeInfo,
+        schemaClass2
+      );
+      if (!isRecord8(entryTypeInfo)) return null;
+      return resolved.selection === 1 /* Multi */ ? { type: 9, required: required2, entryTypeInfo } : { ...entryTypeInfo, required: required2 };
+    }
     if (resolved.kind === 9) {
       if (typeof resolved.collectionMemberId !== "string") return null;
       const collection = membersById.get(resolved.collectionMemberId);
@@ -126694,6 +127090,12 @@ function buildValueEmitIndexesV4(records3, manifest, localizedTextDependencies,
     }
     return listenerBindingOwners = owners;
   };
+  const storedPlacements = storedIndexes?.placements ?? buildStoredValuePlacementIndexV4(records3.values(), values);
+  const rootPathsByValueId = rootValuePathsByValueId(
+    records3.values(),
+    storedPlacements
+  );
+  let rootIndexPaths;
   return {
     records: records3,
     manifest,
@@ -126737,9 +127139,12 @@ function buildValueEmitIndexesV4(records3, manifest, localizedTextDependencies,
     localizedTexts,
     mainLocale: projectMainLocale(records3),
     symbolsByValueId,
-    rootPathsByValueId: rootValuePathsByValueId(
-      records3.values(),
-      storedIndexes?.placements ?? buildStoredValuePlacementIndexV4(records3.values(), values)
+    rootPathsByValueId,
+    readRootIndexPaths: () => rootIndexPaths ??= indexRootIndexPaths(
+      values,
+      manifestMembers,
+      storedPlacements,
+      rootPathsByValueId
     ),
     collectionBindingValueIds: /* @__PURE__ */ new Set([
       ...manifest.members.flatMap(
@@ -127643,7 +128048,7 @@ function buildValueLowerContext(state, manifest, options = {}) {
     ),
     collectionBindingMemberIds: /* @__PURE__ */ new Set([
       ...manifest.members.flatMap(
-        (member) => member.kind === "lookup" ? [member.collectionMemberId] : []
+        (member) => member.kind === "lookup" && member.collectionMemberId !== null ? [member.collectionMemberId] : []
       ),
       ...(manifest.variantFolders ?? []).flatMap(
         (folder) => folder.binding === null ? [] : [folder.binding.collectionMemberId]
@@ -128412,7 +128817,8 @@ function drainValueReferenceObligationsV4(state, manifest, options) {
     const failure = settleReferenceObligation(
       context,
       obligation,
-      deletedValueIds
+      deletedValueIds,
+      options.resolveRootPath
     );
     if (failure === null) continue;
     failures.push({
@@ -128432,6 +128838,7 @@ function collectionValueObligations(manifest) {
   const obligations = [];
   for (const member of manifest.members) {
     if (member.kind !== "lookup") continue;
+    if (member.collectionMemberId === null) continue;
     if (typeof member.collectionValueId !== "string") continue;
     if (member.collectionValueId.startsWith("__pending__:root-path:")) continue;
     obligations.push({
@@ -128449,10 +128856,15 @@ function collectionValueObligations(manifest) {
   }
   return obligations;
 }
-function settleReferenceObligation(context, obligation, deletedValueIds) {
+function settleReferenceObligation(context, obligation, deletedValueIds, resolveRootPath) {
   try {
     if (obligation.kind === "reference") {
-      settleReferenceMember(context, obligation, deletedValueIds);
+      settleReferenceMember(
+        context,
+        obligation,
+        deletedValueIds,
+        resolveRootPath
+      );
       return null;
     }
     if (obligation.kind === "constructorProjection") {
@@ -128465,7 +128877,7 @@ function settleReferenceObligation(context, obligation, deletedValueIds) {
     return error instanceof Error ? error.message : String(error);
   }
 }
-function settleReferenceMember(context, obligation, deletedValueIds) {
+function settleReferenceMember(context, obligation, deletedValueIds, resolveRootPath) {
   const member = context.members.get(obligation.memberId);
   if (member?.kind !== "lookup" && member?.kind !== "dialogueLookup") {
     throw new Error(
@@ -128476,6 +128888,18 @@ function settleReferenceMember(context, obligation, deletedValueIds) {
     settleKeyReference(context, member, obligation.target, obligation);
     return;
   }
+  if (obligation.target.spelling === "indexPath") {
+    const targetId = resolveValidIndexPathTargetId(
+      context,
+      member,
+      obligation.target,
+      obligation.ownerValueId,
+      resolveRootPath
+    );
+    if (targetId === null) return;
+    patchReferenceSlot(member, obligation.target.patch, targetId);
+    return;
+  }
   const target = resolveObligationTarget(
     context,
     obligation.target,
@@ -128491,14 +128915,96 @@ function settleKeyReference(context, member, spelling, obligation) {
     spelling,
     obligation.ownerValueId
   );
-  spelling.patch.ids[spelling.patch.index] = targetId;
-  const patched = spelling.patch.ids.filter((id2) => !isPendingId(id2));
+  patchReferenceSlot(member, spelling.patch, targetId);
+}
+function patchReferenceSlot(member, patch, targetId) {
+  patch.ids[patch.index] = targetId;
+  const patched = patch.ids.filter((id2) => !isPendingId(id2));
   if (new Set(patched).size !== patched.length) {
     throw new Error(
       `Reference member ${member.name} cannot contain duplicate targets.`
     );
   }
 }
+function resolveValidIndexPathTargetId(context, member, spelling, ownerValueId, resolveRootPath) {
+  const source = indexPathSourceV4(spelling);
+  if (member.kind !== "lookup") {
+    throw new Error(
+      `Reference member ${member.name} is a dialogue lookup, and ${source} names a value row. Name the dialogue directly instead.`
+    );
+  }
+  const resolution = resolveRootPath(spelling.listPath);
+  if (resolution.kind === "unavailable") return null;
+  if (resolution.kind === "failed") throw new Error(resolution.message);
+  const listLabel = spelling.listPath.slice("root.".length);
+  const list = indexPathList(context, resolution.valueId, resolution.memberId);
+  if (list === null) {
+    throw new Error(
+      `${spelling.listPath} is not a List, so ${source} has no index to read.`
+    );
+  }
+  const index = (list.indexes ?? []).find(
+    (candidate) => candidate.schemaKey === spelling.indexSchemaKey
+  );
+  if (index === void 0) {
+    throw new Error(
+      `List ${listLabel} declares no index ${spelling.indexSchemaKey}.`
+    );
+  }
+  if (!index.unique) {
+    throw new Error(
+      `Index ${listLabel}.Index.${spelling.indexSchemaKey} is not unique, so it can't name one row.`
+    );
+  }
+  const matches = entriesWithIndexedKey(
+    context,
+    list,
+    [resolution.valueId],
+    index.schemaKey,
+    spelling.key
+  );
+  if (matches.length > 1) {
+    throw new Error(
+      `List ${listLabel} holds ${matches.length} rows whose ${index.schemaKey} is ${JSON.stringify(spelling.key)}, but that index is unique. Fix the duplicate rows; ${source} needs exactly one.`
+    );
+  }
+  const targetId = matches[0];
+  if (targetId === void 0) throw new Error(`${source} names no row.`);
+  const target = referenceTargetById(context, targetId, null);
+  if (target === null) {
+    throw new Error(
+      `${source} resolved to ${targetId}, which names no value row in the project after this push.`
+    );
+  }
+  validateReferenceContract(context, member, target, ownerValueId);
+  return targetId;
+}
+function indexPathList(context, valueId, memberId) {
+  const owners = memberId === null ? valueOwningMemberIds(context, valueId) : [memberId];
+  for (const owner of owners) {
+    const member = context.members.get(owner);
+    if (member?.kind === "list") return member;
+  }
+  return null;
+}
+function entriesWithIndexedKey(context, collection, collectionValueIds, schemaKey, key) {
+  const matches = [];
+  for (const collectionValueId of collectionValueIds) {
+    for (const entryId of collectionEntryIds(
+      context,
+      collection,
+      collectionValueId
+    )) {
+      const entry = valueData(context, entryId);
+      if (!entry || !isObjectRecord2(entry.value)) continue;
+      const fieldRowId = entry.value[schemaKey];
+      if (typeof fieldRowId !== "string") continue;
+      if (valueData(context, fieldRowId)?.value !== key) continue;
+      matches.push(entryId);
+    }
+  }
+  return matches;
+}
 function resolveValidKeyReferenceTargetId(context, member, spelling, ownerValueId) {
   const targetId = resolveKeyReferenceTargetId(
     context,
@@ -128521,6 +129027,9 @@ function resolveKeyReferenceTargetId(context, member, spelling, ownerValueId) {
       `Reference member ${member.name} is a dialogue lookup, and the key form resolves through a value collection's unique index. Name the dialogue directly instead.`
     );
   }
+  if (member.collectionMemberId === null) {
+    throw unboundKeyReferenceError(context, spelling.typeName, member);
+  }
   const collection = context.members.get(member.collectionMemberId);
   if (collection?.kind !== "list") {
     throw new Error(
@@ -128539,21 +129048,13 @@ function resolveKeyReferenceTargetId(context, member, spelling, ownerValueId) {
       `Reference member ${member.name} key ${JSON.stringify(spelling.key)} cannot be resolved: collection ${collectionMemberName2(context, member)} has no value row in the project after this push.`
     );
   }
-  const matches = [];
-  for (const collectionValueId of resolution.valueIds) {
-    for (const entryId of collectionEntryIds(
-      context,
-      collection,
-      collectionValueId
-    )) {
-      const entry = valueData(context, entryId);
-      if (!entry || !isObjectRecord2(entry.value)) continue;
-      const fieldRowId = entry.value[schemaKey];
-      if (typeof fieldRowId !== "string") continue;
-      if (valueData(context, fieldRowId)?.value !== spelling.key) continue;
-      matches.push(entryId);
-    }
-  }
+  const matches = entriesWithIndexedKey(
+    context,
+    collection,
+    resolution.valueIds,
+    schemaKey,
+    spelling.key
+  );
   if (matches.length === 0) {
     throw new Error(
       `Reference member ${member.name} key ${JSON.stringify(spelling.key)} matches no row of collection ${collectionMemberName2(context, member)} under index ${schemaKey}.`
@@ -128708,9 +129209,9 @@ function resolveObligationTarget(context, spelling, deletedValueIds, subject) {
     spelling.patch.ids[spelling.patch.index] = id2;
     return target2;
   }
-  if (spelling.spelling === "key") {
+  if (spelling.spelling === "key" || spelling.spelling === "indexPath") {
     throw new Error(
-      `${subject} carries a key spelling with no collection to resolve it against.`
+      `${subject} carries a ${spelling.spelling} spelling that settleReferenceMember did not resolve.`
     );
   }
   const target = referenceTargetById(context, spelling.id, spelling.typeName);
@@ -128892,6 +129393,9 @@ function defaultRequiresOwnedRows(context, member, sourceExpression, source) {
 }
 function memberInitializerRequiresEvaluation(context, member, expression, source) {
   if (member.kind === "class" && member.partial === true) return false;
+  if (member.kind === "lookup" && isIndexPathReferenceValue(expression)) {
+    return false;
+  }
   const unorderedDefault = source.purpose === "memberDefault" && member.id === source.memberId && member.kind === "list" && member.listKind === "unordered" && expression.kind === "litList" && expression.elements.length > 0;
   const requiresEvaluation = unorderedDefault || context.localValues.readsInstance(expression) || isSchemaMemberValueRead(context, expression, source) || isUnresolvedLiteralName(context, member, expression) || initializerRequiresEvaluation(
     context.declaredConstructors,
@@ -128901,6 +129405,21 @@ function memberInitializerRequiresEvaluation(context, member, expression, source
   );
   return requiresEvaluation;
 }
+function isIndexPathReferenceValue(sourceExpression) {
+  const expression = annotatedValue(sourceExpression).expression;
+  const elements = expression.kind === "litList" ? expression.elements : [expression];
+  let indexPaths = 0;
+  for (const element of elements) {
+    if (parseIndexPathSpellingV4(element) !== null) {
+      indexPaths += 1;
+      continue;
+    }
+    if (element.kind !== "call" || element.callee.kind !== "ident" || element.callee.name !== "Reference") {
+      return false;
+    }
+  }
+  return indexPaths > 0;
+}
 function isSchemaMemberValueRead(context, expression, source) {
   const path = memberPath2(annotatedValue(expression).expression);
   if (path === null) return false;
@@ -132066,6 +132585,18 @@ function lowerReferences(context, member, expression, ownerValueId, source) {
   }
   const ids = [];
   for (const [index, entry] of elements.entries()) {
+    const indexPath = member.kind === "lookup" ? parseIndexPathSpellingV4(entry) : null;
+    if (indexPath !== null) {
+      ids.push(`${PENDING_ID_PREFIX}reference-index:${source.label}:${index}`);
+      context.referenceObligations.push({
+        kind: "reference",
+        site: referenceSite(source, entry),
+        memberId: member.id,
+        ownerValueId,
+        target: { ...indexPath, patch: { ids, index } }
+      });
+      continue;
+    }
     const target = referenceTargetSpelling(context, entry);
     if (target === null) {
       throw new Error(`Reference member ${member.name} has an invalid target.`);
@@ -132238,12 +132769,10 @@ function sourceValueSymbol(context, expression) {
 function resolveKeyReferenceMemberDefaultsV4(args) {
   const pending = /* @__PURE__ */ new Map();
   for (const member of args.manifest.members) {
-    const encoded = memberDefaultKeyPlaceholderInBodyV4(
+    const placeholders = memberDefaultKeyPlaceholdersInBodyV4(
       memberDefaultBody(member)
     );
-    if (encoded === null) continue;
-    const spelling = decodeMemberDefaultKeyReferenceV4(encoded);
-    if (spelling !== null) pending.set(member.id, spelling);
+    if (placeholders.length > 0) pending.set(member.id, placeholders);
   }
   if (pending.size === 0) return /* @__PURE__ */ new Map();
   const deletedValueIds = args.deletedValueIds ?? /* @__PURE__ */ new Set();
@@ -132257,21 +132786,13 @@ function resolveKeyReferenceMemberDefaultsV4(args) {
     })
   });
   const resolved = /* @__PURE__ */ new Map();
-  for (const [memberId, spelling] of pending) {
+  for (const [memberId, placeholders] of pending) {
     const member = context.members.get(memberId);
     if (member?.kind !== "lookup" && member?.kind !== "dialogueLookup") {
       continue;
     }
     const site = args.siteForMember(memberId);
-    try {
-      const targetId = resolveValidKeyReferenceTargetId(
-        context,
-        member,
-        spelling,
-        null
-      );
-      resolved.set(memberId, targetId);
-    } catch (error) {
+    const fail2 = (error) => {
       args.registry.loweringFailures.push({
         message: error instanceof Error ? error.message : String(error),
         site: {
@@ -132281,7 +132802,38 @@ function resolveKeyReferenceMemberDefaultsV4(args) {
           label: member.name
         }
       });
+    };
+    const targets = /* @__PURE__ */ new Map();
+    for (const placeholder of placeholders) {
+      const spelling = decodeMemberDefaultKeyReferenceV4(placeholder);
+      if (spelling === null) continue;
+      try {
+        const targetId = spelling.spelling === "key" ? resolveValidKeyReferenceTargetId(context, member, spelling, null) : resolveValidIndexPathTargetId(
+          context,
+          member,
+          spelling,
+          null,
+          args.resolveRootPath
+        );
+        if (targetId !== null) targets.set(placeholder, targetId);
+      } catch (error) {
+        fail2(error);
+      }
+    }
+    const body = substituteMemberDefaultKeyReferenceV4(
+      memberDefaultBody(member),
+      targets
+    );
+    const ids = Array.isArray(body) ? body : [];
+    if (new Set(ids).size !== ids.length) {
+      fail2(
+        new Error(
+          `Reference member ${member.name} cannot contain duplicate targets.`
+        )
+      );
+      continue;
     }
+    if (targets.size > 0) resolved.set(memberId, targets);
   }
   return resolved;
 }
@@ -132399,6 +132951,9 @@ function initializerKeyLookup(context, target, site, initializer) {
   const storedBody = site.enclosing === null ? valueData(context, initializer.valueId)?.value : void 0;
   const storedFieldRow = isObjectRecord2(storedBody) ? storedBody[site.field] : void 0;
   const ownerValueId = typeof storedFieldRow === "string" ? storedFieldRow : null;
+  if (member.collectionMemberId === null) {
+    throw unboundKeyReferenceError(context, target.typeName, member);
+  }
   const collection = context.members.get(member.collectionMemberId);
   if (ownerValueId === null && collection !== void 0 && classMemberIdByName(context, ownerClassId, collection.name) !== null) {
     throw new Error(
@@ -132477,6 +133032,10 @@ function validateReferenceContract(context, member, target, ownerValueId) {
     if (target.kind !== "value") {
       throw new Error(`Lookup member ${member.name} requires a value target.`);
     }
+    if (member.collectionMemberId === null) {
+      validateUnboundReferenceContract(context, member, target);
+      return;
+    }
     const expectedClassId = lookupEntryClassId2(context, member);
     const expectedTypeName = lookupEntryTypeName(context, member);
     const targetData = valueData(context, target.id);
@@ -132523,6 +133082,55 @@ function validateReferenceContract(context, member, target, ownerValueId) {
   }
   validateDialogueEligibility(context, member, target.id);
 }
+function validateUnboundReferenceContract(context, member, target) {
+  const declaredClassId = unboundReferenceClassId(context, member);
+  const rowClass = unboundTargetRowClass(context, target.id);
+  if (rowClass.kind === "scalar") {
+    throw new Error(
+      `Lookup member ${member.name} target ${target.id} is not a class row. A reference selects a stored class value.`
+    );
+  }
+  const actualClassId = rowClass.kind === "class" ? rowClass.classId : null;
+  if (declaredClassId && actualClassId && !classAssignableToClass(context, actualClassId, declaredClassId)) {
+    throw new Error(
+      `Lookup member ${member.name} target ${target.id} is ${classDisplayName2(context, actualClassId)}, but the member declares ${classDisplayName2(context, declaredClassId)}. Point it at a ${classDisplayName2(context, declaredClassId)} row.`
+    );
+  }
+  if (target.genericTypeName)
+    context.referenceTypes().assertAssignable(
+      target.id,
+      target.genericTypeName,
+      `Reference<${target.genericTypeName}>`
+    );
+}
+function unboundTargetRowClass(context, valueId) {
+  const pending = context.pendingValues.get(valueId);
+  if (pending?.nodeType === "literal") {
+    return pending.classId === null ? { kind: "scalar" } : { kind: "class", classId: pending.classId };
+  }
+  const data = valueData(context, valueId);
+  if (typeof data?.classId === "string")
+    return { kind: "class", classId: data.classId };
+  const placing = pending === void 0 ? storedRowPlacementMember(context, valueId) : memberById(context, pending.memberId);
+  if (placing === null) return { kind: "unknown" };
+  if (placing.kind === "class")
+    return { kind: "class", classId: placing.classId };
+  return placing.kind === "generic" || placing.kind === "variant" ? { kind: "unknown" } : { kind: "scalar" };
+}
+function unboundReferenceClassId(context, member) {
+  const declared = member.declaredType;
+  if (declared?.kind !== "generic")
+    return lookupDeclaredClassId2(context, member);
+  const constraint = context.classes.get(declared.ownerClassId)?.genericParameters.find(
+    (parameter4) => parameter4.id === declared.genericParamId
+  )?.constraint;
+  return constraint?.kind === "class" ? constraint.classId : null;
+}
+function unboundKeyReferenceError(context, typeName, member) {
+  return new Error(
+    `Reference<${typeName}>(key:) resolves through the member's collection, and ${qualifiedMemberName(context, member)} has no collection. Use an index path, id:, or bind a collection.`
+  );
+}
 function lookupDeclaredClassId2(context, member) {
   const declared = member.declaredType;
   if (declared === null) return null;
@@ -132533,6 +133141,7 @@ function classDisplayName2(context, classId) {
   return context.classes.get(classId)?.name ?? classId;
 }
 function lookupEntryTypeName(context, member) {
+  if (member.collectionMemberId === null) return null;
   const collection = context.members.get(member.collectionMemberId);
   const entry = collection?.kind === "list" || collection?.kind === "dictionary" ? context.members.get(collection.entryMemberId) : null;
   if (!entry) return null;
@@ -132558,6 +133167,7 @@ function referenceTypeNameAssignable(context, actualName, expectedName) {
   ) : false;
 }
 function validateLookupMembership(context, member, targetId, ownerValueId) {
+  if (member.collectionMemberId === null) return;
   const collection = context.members.get(member.collectionMemberId);
   if (!collection || collection.kind !== "list" && collection.kind !== "dictionary") {
     throw new Error(
@@ -132592,18 +133202,28 @@ function validateLookupMembership(context, member, targetId, ownerValueId) {
   );
 }
 function collectionMemberName2(context, member) {
+  if (member.collectionMemberId === null) {
+    throw new Error(`Lookup member ${member.name} has no collection.`);
+  }
   const collection = context.members.get(member.collectionMemberId);
   if (collection === void 0) return member.collectionMemberId;
-  const owner = collection.owner;
-  if (owner.kind !== "classMember") return collection.name;
+  return qualifiedMemberName(context, collection);
+}
+function qualifiedMemberName(context, member) {
+  const owner = member.owner;
+  if (owner.kind !== "classMember") return member.name;
   const ownerClass = context.classes.get(owner.classId);
-  if (ownerClass === void 0) return collection.name;
-  return `${ownerClass.name}.${collection.name}`;
+  if (ownerClass === void 0) return member.name;
+  return `${ownerClass.name}.${member.name}`;
 }
 function resolveLookupCollectionValueIds(context, member, collection, ownerValueId) {
   if (typeof member.collectionValueId === "string") {
     return { valueIds: [member.collectionValueId], origin: "declared" };
   }
+  const collectionMemberId = member.collectionMemberId;
+  if (collectionMemberId === null) {
+    throw new Error(`Lookup member ${member.name} has no collection.`);
+  }
   if (ownerValueId !== null) {
     const container = context.valuePlacements.containerBodyByPlacement.get(
       `${member.name}:${ownerValueId}`
@@ -132615,11 +133235,11 @@ function resolveLookupCollectionValueIds(context, member, collection, ownerValue
   }
   const declaredRows = collectionRowsOfDeclaredMember(
     context,
-    member.collectionMemberId,
+    collectionMemberId,
     collection.name
   );
   const candidates = /* @__PURE__ */ new Set();
-  const collectionState = context.state[`member:${member.collectionMemberId}`];
+  const collectionState = context.state[`member:${collectionMemberId}`];
   const collectionMemberData = isObjectRecord2(collectionState?.data) ? collectionState.data : {};
   if (typeof collectionMemberData.valueId === "string") {
     candidates.add(collectionMemberData.valueId);
@@ -132827,6 +133447,7 @@ function validateDialogueEligibility(context, member, dialogueId) {
   }
 }
 function lookupEntryClassId2(context, member) {
+  if (member.collectionMemberId === null) return null;
   const collection = context.members.get(member.collectionMemberId);
   const entry = collection?.kind === "list" || collection?.kind === "dictionary" ? context.members.get(collection.entryMemberId) : null;
   return entry?.kind === "class" ? entry.classId : null;
@@ -134574,9 +135195,17 @@ function schemaTypeForBindingMember(context, memberId, environment, visited = /*
         readOnly: false
       };
     case "lookup": {
+      if (member.collectionMemberId === null && member.declaredType !== null) {
+        return member.multiselect ? { kind: "lookup", nullable: nullable2, entryType: member.declaredType } : withSchemaTypeNullability(member.declaredType, nullable2);
+      }
       if (member.declaredType !== null) {
         return withSchemaTypeNullability(member.declaredType, nullable2);
       }
+      if (member.collectionMemberId === null) {
+        throw new Error(
+          `Lookup member ${member.name} has neither a collection nor a declared type.`
+        );
+      }
       const collection = context.manifestMembers.get(member.collectionMemberId);
       if (collection?.kind !== "list" && collection?.kind !== "dictionary") {
         throw new Error(
@@ -135326,21 +135955,31 @@ function referenceValue(context, member, body, dialogue) {
     }
     const symbol = context.localValues?.byValueId.get(id2)?.name ?? context.symbolsByValueId.get(id2);
     if (symbol !== void 0) return `Reference(${symbol})`;
-    const type = dialogue ? "NeoDialogue" : memberReferenceType(context, member);
+    const type = dialogue ? "NeoDialogue" : unboundReferenceTypeName(context, member, id2) ?? memberReferenceType(context, member);
     if (!dialogue) {
-      const key = uniqueIndexKeyForTarget(context, member, id2);
-      if (key !== null) return `Reference<${type}>(key: ${quote3(key)})`;
+      const manifestMember = context.manifestMembers.get(
+        stringField2(member, "id")
+      );
+      if (manifestMember?.kind === "lookup") {
+        if (manifestMember.collectionMemberId === null) {
+          const path = indexPathForTarget(context, manifestMember, id2);
+          if (path !== null) return path;
+        } else {
+          const key = uniqueIndexKeyForTarget(
+            context,
+            manifestMember.collectionMemberId,
+            id2
+          );
+          if (key !== null) return `Reference<${type}>(key: ${quote3(key)})`;
+        }
+      }
     }
     return `Reference<${type}>(id: ${quote3(id2)})`;
   });
   return isMultiSelectionMember(member) ? `[${values.join(", ")}]` : values[0] ?? "null";
 }
-function uniqueIndexKeyForTarget(context, member, targetId) {
-  const manifestMember = context.manifestMembers.get(stringField2(member, "id"));
-  if (manifestMember?.kind !== "lookup") return null;
-  const collection = context.manifestMembers.get(
-    manifestMember.collectionMemberId
-  );
+function uniqueIndexKeyForTarget(context, collectionMemberId, targetId) {
+  const collection = context.manifestMembers.get(collectionMemberId);
   if (collection?.kind !== "list") return null;
   const unique = (collection.indexes ?? []).filter((index) => index.unique);
   const only = unique.length === 1 ? unique[0] : void 0;
@@ -135356,6 +135995,51 @@ function uniqueIndexKeyForTarget(context, member, targetId) {
   }
   return holders === 1 ? key : null;
 }
+function indexPathForTarget(context, member, targetId) {
+  const path = context.readRootIndexPaths().get(targetId);
+  if (path === void 0) return null;
+  const unwrap = member.multiselect || member.required ? "!" : "";
+  return `${path}${unwrap}`;
+}
+function indexRootIndexPaths(values, manifestMembers, placements, rootPaths) {
+  const lists = /* @__PURE__ */ new Map();
+  for (const [valueId, path] of rootPaths) {
+    const memberId = placements.placementByChildValueId.get(valueId)?.memberId;
+    const list = memberId === null || memberId === void 0 ? void 0 : manifestMembers.get(memberId);
+    if (list?.kind !== "list") continue;
+    const index = (list.indexes ?? []).find((candidate) => candidate.unique);
+    if (index === void 0) continue;
+    lists.set(valueId, { path, list, schemaKey: index.schemaKey });
+  }
+  const paths = /* @__PURE__ */ new Map();
+  if (lists.size === 0) return paths;
+  const unorderedEntries = /* @__PURE__ */ new Map();
+  for (const [id2, row] of values) {
+    const containerId = row.containerId;
+    if (typeof containerId !== "string") continue;
+    if (lists.get(containerId)?.list.listKind !== "unordered") continue;
+    const contained = unorderedEntries.get(containerId) ?? [];
+    contained.push(id2);
+    unorderedEntries.set(containerId, contained);
+  }
+  const context = { values };
+  for (const [listValueId, { path, list, schemaKey }] of lists) {
+    const body = values.get(listValueId)?.value;
+    const entryIds = list.listKind === "unordered" ? unorderedEntries.get(listValueId) ?? [] : Array.isArray(body) ? body.filter((entry) => typeof entry === "string") : [];
+    const entryByKey = /* @__PURE__ */ new Map();
+    for (const id2 of entryIds) {
+      const key = indexedFieldValue(context, id2, schemaKey);
+      if (key === null || key.length === 0) continue;
+      entryByKey.set(key, entryByKey.has(key) ? null : id2);
+    }
+    for (const [key, id2] of entryByKey) {
+      if (id2 !== null) {
+        paths.set(id2, `${path}.Index.${schemaKey}[${quote3(key)}]`);
+      }
+    }
+  }
+  return paths;
+}
 function indexedFieldValue(context, rowId, schemaKey) {
   const row = context.values.get(rowId);
   const body = row?.value;
@@ -135577,6 +136261,15 @@ function projectMainLocale(records3) {
   );
   return isObjectRecord2(config?.data) && typeof config.data.mainLocale === "string" ? config.data.mainLocale : "en-US";
 }
+function unboundReferenceTypeName(context, member, targetId) {
+  const manifestMember = context.manifestMembers.get(stringField2(member, "id"));
+  if (manifestMember?.kind !== "lookup") return null;
+  if (manifestMember.collectionMemberId !== null) return null;
+  const declared = manifestMember.declaredType;
+  const classId = declared?.kind === "class" ? declared.classId : context.values.get(targetId)?.classId;
+  if (typeof classId !== "string") return null;
+  return context.manifestClasses.get(classId)?.name ?? null;
+}
 function memberReferenceType(context, member) {
   if (typeof member.classId === "string") {
     const target = context.classes.get(member.classId);
@@ -140338,6 +141031,39 @@ function resolveRootPathVariantFolderCollectionValuesV4(args) {
   }
   return resolved;
 }
+function createRootValuePathResolverV4(args) {
+  let placements;
+  let rootValues;
+  return (path) => {
+    placements ??= prospectiveStoredValuePlacements(
+      args.state,
+      args.registry,
+      args.manifest
+    );
+    if (rootValues === void 0) rootValues = rootSlotValueIds(args.state);
+    const failures = [];
+    const valueId = walkRootValuePath(
+      path,
+      args.state,
+      args.registry,
+      placements,
+      rootValues,
+      (failure) => failures.push(failure),
+      args.resolveVirtualPath,
+      args.unavailableSlots,
+      "Index path"
+    );
+    if (valueId !== null) {
+      return {
+        kind: "resolved",
+        valueId,
+        memberId: placements.placementByChildValueId.get(valueId)?.memberId ?? null
+      };
+    }
+    const message = failures[0];
+    return message === void 0 ? { kind: "unavailable" } : { kind: "failed", message };
+  };
+}
 function resolveRootPathDialogueGroupCollectionValuesV4(args) {
   let placements;
   let rootValues;
@@ -140389,12 +141115,12 @@ function rootSlotValueIds(state) {
   }
   return values;
 }
-function walkRootValuePath(path, state, registry, placements, rootValues, fail2, resolveVirtualPath, unavailableSlots) {
+function walkRootValuePath(path, state, registry, placements, rootValues, fail2, resolveVirtualPath, unavailableSlots, subject = "collectionValue path") {
   const segments = path.split(".");
   const slotName = segments[1];
   if (segments[0] !== "root" || slotName === void 0) {
     fail2(
-      `collectionValue path ${path} must start at a root slot (root.Assets, root.Save, root.Session, or root.User).`
+      `${subject} ${path} must start at a root slot (root.Assets, root.Save, root.Session, or root.User).`
     );
     return null;
   }
@@ -140404,14 +141130,14 @@ function walkRootValuePath(path, state, registry, placements, rootValues, fail2,
   );
   if (slotIndex < 0 || rootValues === null) {
     fail2(
-      `collectionValue path ${path} names root slot ${slotName ?? "<none>"}, which is not Assets, Save, Session, or User.`
+      `${subject} ${path} names root slot ${slotName ?? "<none>"}, which is not Assets, Save, Session, or User.`
     );
     return null;
   }
   const slotValueId = rootValues.get(slotName);
   if (typeof slotValueId !== "string") {
     fail2(
-      `collectionValue path ${path} cannot start: root slot ${slotName} has no stable value row.`
+      `${subject} ${path} cannot start: root slot ${slotName} has no stable value row.`
     );
     return null;
   }
@@ -140421,13 +141147,13 @@ function walkRootValuePath(path, state, registry, placements, rootValues, fail2,
     const body = (pending?.nodeType === "literal" ? pending.value : void 0) ?? (isObjectRecord2(state[`value:${cursor}`]?.data) ? (state[`value:${cursor}`]?.data).value : void 0);
     if (Array.isArray(body)) {
       fail2(
-        `collectionValue path ${path} travels through a list at segment ${segment}; a path cannot choose a list entry. Name the row with Reference(id: ...) instead.`
+        `${subject} ${path} travels through a list at segment ${segment}; a path cannot choose a list entry. Name the row with Reference(id: ...) instead.`
       );
       return null;
     }
     if (!isObjectRecord2(body)) {
       fail2(
-        `collectionValue path ${path} stops before segment ${segment}: the row it reaches stores no single-valued members.`
+        `${subject} ${path} stops before segment ${segment}: the row it reaches stores no single-valued members.`
       );
       return null;
     }
@@ -140438,12 +141164,12 @@ function walkRootValuePath(path, state, registry, placements, rootValues, fail2,
         if (resolved != null) return resolved;
       } catch (error) {
         fail2(
-          `collectionValue path ${path} could not resolve its construction: ${error instanceof Error ? error.message : String(error)}`
+          `${subject} ${path} could not resolve its construction: ${error instanceof Error ? error.message : String(error)}`
         );
         return null;
       }
       fail2(
-        `collectionValue path ${path} has no value at segment ${segment} after this push.`
+        `${subject} ${path} has no value at segment ${segment} after this push.`
       );
       return null;
     }
@@ -142319,6 +143045,7 @@ function emitProjectDocumentSourcesV4(records3, options = {}) {
     fileSymbols: qualifiedProjectFileSymbolsV4(indexes3),
     relationEndpointExpressions: relationEndpointExpressions(records3),
     collectionValuePaths: indexes3.rootPathsByValueId,
+    referenceTargetSource: (member, targetId) => indexPathForTarget(indexes3, member, targetId),
     variantInitializers: variantValues.initializers,
     listenerStatementsByMember: listenerStatements
   });
@@ -143450,10 +144177,18 @@ function computeStatus(workspace, options, conflictedFiles, parseErrors, parseWa
       }
     }
   }
+  const resolveRootPath = createRootValuePathResolverV4({
+    manifest,
+    state: rootPathResolutionState,
+    resolveVirtualPath,
+    unavailableSlots: rootValues.unavailableSlots,
+    registry: valueLowerRegistry
+  });
   const resolvedDefaultKeys = resolveKeyReferenceMemberDefaultsV4({
     manifest,
     state: rootPathResolutionState,
     registry: valueLowerRegistry,
+    resolveRootPath,
     ...projectAnalysisV4 === null ? {} : { analysis: projectAnalysisV4 },
     siteForMember: (memberId) => {
       const span2 = sourceByKey.get(recordStateKey("member", memberId))?.span;
@@ -143464,8 +144199,8 @@ function computeStatus(workspace, options, conflictedFiles, parseErrors, parseWa
     manifest = {
       ...manifest,
       members: manifest.members.map((member) => {
-        const resolvedId = resolvedDefaultKeys.get(member.id);
-        if (resolvedId === void 0) return member;
+        const resolvedTargets = resolvedDefaultKeys.get(member.id);
+        if (resolvedTargets === void 0) return member;
         const defaultValue = member.defaultValue;
         if (defaultValue === null || defaultValue === void 0) return member;
         if (!("value" in defaultValue)) return member;
@@ -143475,20 +144210,20 @@ function computeStatus(workspace, options, conflictedFiles, parseErrors, parseWa
             ...defaultValue,
             value: substituteMemberDefaultKeyReferenceV4(
               defaultValue.value,
-              resolvedId
+              resolvedTargets
             )
           }
         };
       })
     };
-    for (const [memberId, resolvedId] of resolvedDefaultKeys) {
+    for (const [memberId, resolvedTargets] of resolvedDefaultKeys) {
       const document = documentsByKey.get(recordStateKey("member", memberId));
       if (document !== void 0 && isObjectRecord2(document.data)) {
         const stored = document.data.defaultValue;
         if (isObjectRecord2(stored) && "value" in stored) {
           stored.value = substituteMemberDefaultKeyReferenceV4(
             stored.value,
-            resolvedId
+            resolvedTargets
           );
         }
       }
@@ -143497,7 +144232,7 @@ function computeStatus(workspace, options, conflictedFiles, parseErrors, parseWa
       if (isObjectRecord2(authored) && "value" in authored) {
         authored.value = substituteMemberDefaultKeyReferenceV4(
           authored.value,
-          resolvedId
+          resolvedTargets
         );
       }
     }
@@ -143739,7 +144474,16 @@ function computeStatus(workspace, options, conflictedFiles, parseErrors, parseWa
       deletedValueIds,
       unavailableReferenceMemberIds,
       unavailableValueIds: rootValues.unavailableValueIds,
-      sourceTextByUri
+      sourceTextByUri,
+      // Built again here: later passes add rows the first resolver's graph
+      // snapshot does not hold.
+      resolveRootPath: createRootValuePathResolverV4({
+        manifest,
+        state: rootPathResolutionState,
+        resolveVirtualPath,
+        unavailableSlots: rootValues.unavailableSlots,
+        registry: valueLowerRegistry
+      })
     }
   );
   for (const failure of referenceFailures) {
@@ -149556,7 +150300,8 @@ function expectedTypeAt(snapshot, offset, body = lambdaBodyAt(snapshot, offset),
     const token = tokens[index];
     if (token.kind !== "operator" || token.text !== "=") continue;
     const local = features.locals.get(tokens[index - 1]?.start ?? -1);
-    const type = local && !local.inferred && !local.collectionIteration ? resolveDeclaredType(local, snapshot) : resolveChain(snapshot, expressionTokensBefore(tokens, index), offset)?.type;
+    if (local?.inferred) break;
+    const type = local && !local.collectionIteration ? resolveDeclaredType(local, snapshot) : resolveChain(snapshot, expressionTokensBefore(tokens, index), offset)?.type;
     if (type) {
       return expectedCollectionElementType(type, tokens, token.end, offset);
     }
@@ -150382,7 +151127,19 @@ function resolveChain(snapshot, tokens, offset, expectedType) {
   const staticRoot = tokens[0]?.kind === "type" ? snapshot.project.typeByName.get(tokens[0].text) : void 0;
   let current;
   let cursor;
-  if (tokens[0]?.text === "[" || tokens[0]?.text === "{") {
+  if (tokens[0]?.text === "(") {
+    const close = matchingDelimiterIndex(tokens, 0);
+    if (close < 0) return null;
+    current = {
+      type: inferExpressionType2(
+        tokens.slice(1, close),
+        snapshot,
+        offset,
+        expectedType
+      )
+    };
+    cursor = close + 1;
+  } else if (tokens[0]?.text === "[" || tokens[0]?.text === "{") {
     const close = matchingDelimiterIndex(tokens, 0);
     if (close < 0) return null;
     current = {
@@ -150395,6 +151152,21 @@ function resolveChain(snapshot, tokens, offset, expectedType) {
       staticType: staticRoot
     };
     cursor = 1;
+    if (staticRoot.id === NEOSCRIPT_LIST_TYPE_ID && tokens[1]?.text === "." && tokens[2]?.text === NEOSCRIPT_LIST_REPEAT_NAME) {
+      const open = callOpenParenIndex(tokens, 2);
+      const close = open < 0 ? -1 : findClosingToken(tokens, open, "(", ")");
+      if (close >= 0) {
+        current = {
+          type: inferListRepeatType(
+            snapshot,
+            tokens.slice(open + 1, close),
+            open > 3 ? callTypeArgumentTokens(tokens, 2, open) : void 0,
+            close === tokens.length - 1 ? expectedType : void 0
+          )
+        };
+        cursor = close + 1;
+      }
+    }
   } else if (contextualConstructor || constructorType?.constructorSignature) {
     current = {
       type: contextualConstructor ? expectedType : constructedTypeRef(snapshot, constructorType, tokens, 1)
@@ -150463,10 +151235,7 @@ function resolveChain(snapshot, tokens, offset, expectedType) {
         fallbackType,
         current.symbol?.name === "SelectMany"
       ) : fallbackType;
-      current = {
-        type: callType,
-        ...current.symbol ? { symbol: current.symbol } : {}
-      };
+      current = { type: callType };
       cursor = close < 0 ? tokens.length : close + 1;
       continue;
     }
@@ -150485,6 +151254,32 @@ function resolveChain(snapshot, tokens, offset, expectedType) {
   }
   return current;
 }
+function inferListRepeatType(snapshot, argumentTokens, typeArgumentTokens, expectedType) {
+  const comma = topLevelTokenIndex(
+    argumentTokens,
+    (token) => token.text === ","
+  );
+  const valueTokens = comma < 0 ? argumentTokens : argumentTokens.slice(0, comma);
+  if (!valueTokens[0]) return UNKNOWN_TYPE;
+  let expectedEntry = expectedType?.kind === "list" ? expectedType.elementType : void 0;
+  if (typeArgumentTokens) {
+    const parser = new Parser(typeArgumentTokens);
+    if (parser.typeEnd() !== typeArgumentTokens.length) return UNKNOWN_TYPE;
+    expectedEntry = resolveAuthoredType(parser, snapshot) ?? UNKNOWN_TYPE;
+  }
+  const value = inferExpressionType2(
+    valueTokens,
+    snapshot,
+    valueTokens[0].start,
+    expectedEntry
+  );
+  const elementType = commonNeoScriptAssignableType(
+    expectedEntry ?? value,
+    value,
+    snapshot.project
+  );
+  return elementType ? { kind: "list", elementType } : UNKNOWN_TYPE;
+}
 function inferSelectResultType(argumentTokens, snapshot, fallbackType, flatten = false) {
   const arrow = topLevelTokenIndex(
     argumentTokens,
@@ -151002,7 +151797,16 @@ function inferExpressionType2(rawTokens, snapshot, offset, expectedType) {
   if (first.kind === "operator" && (first.text === "!" || first.text === "-")) {
     return first.text === "!" ? { kind: "primitive", name: "bool" } : inferExpressionType2(tokens.slice(1), snapshot, offset);
   }
-  return resolveChain(snapshot, tokens, offset, expectedType)?.type ?? UNKNOWN_TYPE;
+  const resolved = resolveChain(snapshot, tokens, offset, expectedType);
+  const symbol = resolved?.symbol;
+  if (symbol?.kind === "method" || symbol?.kind === "function") {
+    return {
+      kind: "delegate",
+      parameterTypes: symbol.parameters?.map((parameter4) => parameter4.type) ?? [],
+      returnType: symbol.returnType ?? symbol.type
+    };
+  }
+  return resolved?.type ?? UNKNOWN_TYPE;
 }
 function unwrapExpressionTokens(tokens) {
   let result = tokens;
@@ -153742,11 +154546,14 @@ ${resolved.symbol.documentation}` : "";
 
 ID: \`${resolved.symbol.id}\`` : "\n\nPending ID";
   const detail = resolved.symbol.detail ? `: \`${resolved.symbol.detail}\`` : "";
+  const reference2 = resolved.symbol.reference ? `
+
+\`${resolved.symbol.reference.storage}\` reads as \`${resolved.symbol.reference.readsAs}\`.` : "";
   const contract = resolved.symbol.kind === "class" ? projectConstructionContractMarkdown(analysis, resolved.symbol.name) : "";
   const lifecycle = resolved.symbol.kind === "member" && resolved.symbol.callable === true && resolved.symbol.static !== true && analysis.documents.get(resolved.symbol.location.uri)?.kind !== "flow" ? lifecycleHoverMarkdown(analysis, resolved.symbol.name) : "";
   return {
     range: resolved.token.range,
-    markdown: `**${resolved.symbol.kind}** \`${resolved.symbol.name}\`${detail}${owner}${documentation}${lifecycle}${contract}${id2}`
+    markdown: `**${resolved.symbol.kind}** \`${resolved.symbol.name}\`${detail}${owner}${reference2}${documentation}${lifecycle}${contract}${id2}`
   };
 }
 function projectBuiltinSymbolAt(document, position) {
@@ -156712,6 +157519,7 @@ var init_service = __esm({
     init_project_source_identifiers();
     init_project_source_analysis();
     init_project_source_construction_quick_fixes();
+    init_project_source_reference_spelling();
     init_project_source_lifecycle_editor();
     init_project_source_reference_family();
     init_project_source_language_features();
@@ -157109,6 +157917,13 @@ var init_service = __esm({
             actions.push(
               ...projectConstructionQuickFixes(project, state.document, diagnostic)
             );
+            actions.push(
+              ...projectReferenceSpellingQuickFixes(
+                project,
+                state.document,
+                diagnostic
+              )
+            );
             actions.push(
               ...projectLifecycleQuickFixes(
                 project,
@@ -164216,13 +165031,15 @@ function storedMemberKindInfo(member, members, genericEnv) {
     };
   }
   if (isMemberLookupBase(resolved)) {
-    const collection = members.find(
-      (candidate) => candidate.id === resolved.collectionMemberId
-    );
-    if (!collection) return null;
     const declaredInfo = lookupDeclaredTypeInfo2(
       resolved,
-      storedMemberKindInfo(collection, members, genericEnv) ?? null
+      (collectionMemberId) => {
+        const collection = members.find(
+          (candidate) => candidate.id === collectionMemberId
+        );
+        if (!collection) return null;
+        return storedMemberKindInfo(collection, members, genericEnv) ?? null;
+      }
     );
     if (declaredInfo === null || genericEnv === void 0) return declaredInfo;
     return substituteTypeInfoForConformance(
@@ -169970,8 +170787,7 @@ function staticStoredSetter(ctx, member, memberId, storage) {
     return [...lines, "binding.BindValue(value);"];
   }
   if (isMemberLookupBase(member)) {
-    const entryMember = resolveLookupEntryMember(ctx, member);
-    const classTarget = entryMember !== null && isMemberClassBase(entryMember);
+    const classTarget = lookupTargetsClass(ctx, member);
     if (isMultiSelectionMember(member)) {
       return [
         ...lines,
@@ -170015,7 +170831,7 @@ function staticLookupGetter(ctx, member, memberId, storage, saved, valueType, ge
   if (targetClass !== null) {
     const typeName = ctx.typeNames.get(targetClass.classId) ?? "NeoNode";
     const typeRef = `${qualifyGeneratedType(ctx, savedTypeName(typeName))}${targetClass.constructedSuffix}`;
-    factory = targetSaved ? `${typeRef}.CreateWritable(client, (NeoMemberClassWritable)__selected__)` : `${typeRef}.Create(client, (NeoMemberClass)__selected__)`;
+    factory = lookupHasRuntimeOwnership(member) ? `__selected__ is NeoMemberClassWritable writableSelected ? ${typeRef}.CreateWritable(client, writableSelected) : ${typeRef}.Create(client, (NeoMemberClass)__selected__)` : targetSaved ? `${typeRef}.CreateWritable(client, (NeoMemberClassWritable)__selected__)` : `${typeRef}.Create(client, (NeoMemberClass)__selected__)`;
   } else {
     factory = 'new NeoLookupSelection(__selected__.overrideValueId ?? throw new InvalidOperationException("Lookup selected a value without an id."))';
   }
@@ -171916,8 +172732,7 @@ function writeExpression(ctx, member, schemaKey, ownerClassName, ownerClassId) {
     ];
   }
   if (isMemberLookupBase(member)) {
-    const entryMember = resolveLookupEntryMember(ctx, member);
-    const classTarget = entryMember !== null && isMemberClassBase(entryMember);
+    const classTarget = lookupTargetsClass(ctx, member);
     return isMultiSelectionMember(member) ? [
       "var ids = new List<string>();",
       "if (value is not null)",
@@ -172099,6 +172914,8 @@ function lookupSelectionFactory(ctx, member, selection2, saved, writeGuardMember
   const typeName = ctx.typeNames.get(targetClass.classId) ?? "NeoNode";
   const savedTypeRef = qualifyGeneratedType(ctx, savedTypeName(typeName));
   const writable = `writable${selection2[0].toUpperCase()}${selection2.slice(1)}`;
+  if (lookupHasRuntimeOwnership(member))
+    return `${selection2} is NeoMemberClassWritable ${writable} ? ${savedTypeRef}.CreateWritable(client, ${writable}) : ${savedTypeRef}.Create(client, (NeoMemberClass)${selection2})`;
   return targetSaved && writeGuardMemberName != null ? `${selection2} is NeoMemberClassWritable ${writable} && !IsReadOnly ? ${savedTypeRef}.CreateWritable(client, ${writable}) : ${savedTypeRef}.Create(client, (NeoMemberClass)${selection2})` : targetSaved ? `${savedTypeRef}.CreateWritable(client, (NeoMemberClassWritable)${selection2})` : `${savedTypeRef}.Create(client, (NeoMemberClass)${selection2})`;
 }
 function lookupReadExpression(ctx, member, getNode, schemaKey, saved, writeGuardMemberName, genericEnv) {
@@ -174789,9 +175606,14 @@ function memberTypeInfo(member, context, seen = /* @__PURE__ */ new Set()) {
     };
   }
   if (isMemberLookupBase(resolved)) {
-    const collection = context.membersById?.get(resolved.collectionMemberId);
-    const collectionTypeInfo = memberTypeInfo(collection, context, seen);
-    return lookupDeclaredTypeInfo2(resolved, collectionTypeInfo ?? null);
+    return lookupDeclaredTypeInfo2(
+      resolved,
+      (collectionMemberId) => memberTypeInfo(
+        context.membersById?.get(collectionMemberId),
+        context,
+        seen
+      ) ?? null
+    );
   }
   const candidate = {
     type: resolved.kind,
@@ -195473,7 +196295,7 @@ There is no --keep-current: preserving current semantic state defines flatten.
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.command === "--version") {
-    console.log("0.76.3");
+    console.log("0.77.0");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {