@neocompose/cli 0.49.0 → 0.50.1

package/dist/neo.mjs

@@ -10166,6 +10166,14 @@ var init_strict_resolver = __esm({
             );
           }
           case "annotated":
+            if (expression.annotations.some(
+              (annotation2) => annotation2.name === "tile"
+            )) {
+              throw new CompileError(
+                "@tile is only supported on persisted literal placements, not executable NeoScript constructions.",
+                expression.pos
+              );
+            }
             return this.resolveExpression(expression.expression, scope, expected);
           case "binary":
             return this.resolveBinary(expression, scope);
@@ -14498,8 +14506,12 @@ function compileNeoScriptStrict(document, context, options = {}) {
     };
   }
 }
-function assertNeoScriptCompiles(document, context) {
-  const result = compileNeoScriptStrict(document, context);
+function assertNeoScriptCompiles(document, context, projectIndex) {
+  const result = compileNeoScriptStrict(
+    document,
+    context,
+    projectIndex === void 0 ? {} : { projectIndex }
+  );
   const diagnostic = result.diagnostics[0];
   if (diagnostic) {
     throw new CompileError(diagnostic.message, {
@@ -14578,8 +14590,8 @@ function attachDependencyManifest(compiled, syntax, project, context) {
     recordIds.add(alias.valueId);
     collectDependencyIds(alias.type, null, recordIds);
   }
-  const typeNames = [...project.typeByName.keys()].filter(
-    (name) => identifiers.has(name)
+  const typeNames = [...identifiers].filter(
+    (name) => project.typeByName.has(name)
   );
   return {
     ...compiled,
@@ -17880,6 +17892,55 @@ var init_project_source_registry = __esm({
   }
 });
 
+// ../packages/neoscript-language/src/project-source-tile.ts
+function tileAssetAnnotation(expression) {
+  if (expression.kind !== "annotated") return null;
+  const annotations = expression.annotations.filter(
+    (entry) => entry.name === "tile"
+  );
+  const annotation2 = annotations[0];
+  if (annotation2 === void 0) return null;
+  if (annotations.length > 1) {
+    throw new CompileError(
+      "A placement can have only one @tile annotation.",
+      annotations[1].pos
+    );
+  }
+  if (expression.expression.kind !== "new") {
+    throw new CompileError(
+      "@tile requires a NeoTileInstance construction.",
+      annotation2.pos
+    );
+  }
+  if (annotation2.args.length !== 1) {
+    throw new CompileError(
+      "@tile requires exactly one tile class: @tile(VoidTile) or @tile(asset: VoidTile).",
+      annotation2.pos
+    );
+  }
+  const name = annotation2.argumentNames?.[0];
+  if (name != null && name !== "asset") {
+    throw new CompileError(
+      `@tile has no '${name}' option. Use 'asset'.`,
+      annotation2.pos
+    );
+  }
+  const asset = annotation2.args[0];
+  if (asset.kind !== "ident") {
+    throw new CompileError(
+      "@tile asset must name a concrete tile class.",
+      asset.pos
+    );
+  }
+  return asset.name;
+}
+var init_project_source_tile = __esm({
+  "../packages/neoscript-language/src/project-source-tile.ts"() {
+    "use strict";
+    init_strict_compile_error();
+  }
+});
+
 // ../packages/neoscript-language/src/project-schema-contract.generated.ts
 var PROJECT_FILE_UPLOAD_BATCH_SIZE, NEO_PROJECT_SOURCE_RECORD_CONTRACT;
 var init_project_schema_contract_generated = __esm({
@@ -22911,7 +22972,48 @@ function validateExpression(expression, expected, scope, environment, uri, range
     return;
   }
   if (expression.kind === "annotated") {
+    const assetName = tileAssetAnnotation(expression);
+    if (assetName !== null) {
+      const constructed = expression.expression;
+      const className = constructed.kind === "new" ? constructed.className ?? expected?.name : void 0;
+      const asset = environment.types.get(assetName);
+      if (!className || !classExtends(className, "NeoTileInstance", environment, /* @__PURE__ */ new Set())) {
+        pushDiagnostic(
+          diagnostics,
+          uri,
+          range2,
+          "invalid-tile-placement",
+          "@tile requires a NeoTileInstance construction."
+        );
+      }
+      if (!asset || !classExtends(assetName, "NeoTile", environment, /* @__PURE__ */ new Set())) {
+        pushDiagnostic(
+          diagnostics,
+          uri,
+          range2,
+          "invalid-tile-asset",
+          `@tile asset '${assetName}' must name a tile class.`
+        );
+      } else if (asset.modifiers.includes("abstract")) {
+        pushDiagnostic(
+          diagnostics,
+          uri,
+          range2,
+          "invalid-tile-asset",
+          `@tile asset '${assetName}' must be a concrete tile class.`
+        );
+      } else if (asset.genericParameters.length > 0) {
+        pushDiagnostic(
+          diagnostics,
+          uri,
+          range2,
+          "invalid-tile-asset",
+          `@tile asset '${assetName}' must be a non-generic tile class.`
+        );
+      }
+    }
     for (const annotation2 of expression.annotations) {
+      if (annotation2.name === "tile") continue;
       validateInlineAnnotation(
         annotation2,
         environment,
@@ -23444,7 +23546,7 @@ function validateInlineAnnotation(annotation2, environment, uri, range2, diagnos
       uri,
       range2,
       "invalid-inline-annotation",
-      `Only @id is valid on an inline persisted value; got @${annotation2.name}.`
+      `Only @id and @tile are valid on an inline persisted value; got @${annotation2.name}.`
     );
     return;
   }
@@ -24011,6 +24113,7 @@ var init_project_source_semantics = __esm({
   "../packages/neoscript-language/src/project-source-semantics.ts"() {
     "use strict";
     init_project_local_values();
+    init_project_source_tile();
     init_language_spec();
     init_project_schema_contract_generated();
     init_strict_compile_error();
@@ -27739,6 +27842,28 @@ function projectCompletions(analysis, document, position) {
       items: [...script.items, variantScopeInBody]
     };
   }
+  const tileCall = activeTileAnnotation(document, position);
+  if (tileCall) {
+    const items = analysis.symbols.filter(
+      (symbol) => symbol.kind === "class" && projectTypeNameAssignable(analysis, symbol.name, "NeoTile")
+    ).filter((symbol) => {
+      const declaration = analysis.documents.get(symbol.location.uri)?.declarations.find(
+        (entry) => entry.kind === "class" && entry.name === symbol.name
+      );
+      return declaration?.kind === "class" && !declaration.modifiers.includes("abstract") && declaration.genericParameters.length === 0;
+    }).map((symbol) => ({
+      label: symbol.name,
+      kind: "class",
+      insertText: symbol.name
+    }));
+    if (!tileCall.named)
+      items.unshift({
+        label: "asset",
+        kind: "property",
+        insertText: "asset: "
+      });
+    return { isIncomplete: false, items };
+  }
   const annotations = projectAnnotationCompletions(
     analysis,
     document,
@@ -27864,12 +27989,32 @@ function projectCompletions(analysis, document, position) {
   }
   return projectFallbackCompletions(analysis, document, position);
 }
+function isTileAssetToken(tokens, index) {
+  const open = tokens[index - 1]?.text === ":" && tokens[index - 2]?.text === "asset" ? index - 3 : index - 1;
+  return tokens[index + 1]?.text !== ":" && tokens[open]?.text === "(" && tokens[open - 1]?.text === "tile" && tokens[open - 2]?.text === "@";
+}
+function activeTileAnnotation(document, position) {
+  const tokens = projectTokens(document);
+  const open = activeCallOpenIndex(tokens, position);
+  if (tokens[open - 1]?.text !== "tile" || tokens[open - 2]?.text !== "@")
+    return null;
+  const before = tokens.slice(open + 1).filter((token) => positionCompare2(token.range.start, position) < 0);
+  if (before.some((token) => token.text === ",")) return null;
+  const named = before.some((token) => token.text === ":");
+  return { named };
+}
 function projectAnnotationCompletions(analysis, document, position) {
   const source = new SourceText(document.text);
   const offset = source.offsetAt(position);
   const word = projectWordRange(document.text, offset);
   if (document.text[word.start - 1] !== "@") return null;
-  if (initializerRootAt(analysis, document, position)) return [];
+  if (initializerRootAt(analysis, document, position)) {
+    return ["id", "tile"].map((name) => ({
+      label: `@${name}`,
+      kind: "snippet",
+      insertText: name
+    }));
+  }
   const names = projectAnnotationNamesAt(analysis, document, position);
   return names.map((name) => ({
     label: `@${name}`,
@@ -29307,7 +29452,7 @@ function indexedProjectSymbolAt(analysis, document, position, index) {
   );
   const source = analysis.documents.get(document.uri);
   const typePosition = source && sourceTypeAt(source, token.range.start);
-  if (typePosition || sourceTokens[tokenIndex - 1]?.text === "new") {
+  if (typePosition || sourceTokens[tokenIndex - 1]?.text === "new" || isTileAssetToken(sourceTokens, tokenIndex)) {
     const types = candidates.filter(
       (symbol) => symbol.kind === "class" || symbol.kind === "interface" || symbol.kind === "enum" || symbol.kind === "genericParameter"
     );
@@ -29547,6 +29692,8 @@ function annotationSignatureParameters(name) {
   switch (name) {
     case "id":
       return ["string id"];
+    case "tile":
+      return ["NeoTile class asset"];
     case "settings":
       return ["named settings"];
     case "storage":
@@ -33361,6 +33508,7 @@ var init_service = __esm({
     init_test_prelude();
     LanguageService = class {
       documents = /* @__PURE__ */ new Map();
+      specSnapshots = /* @__PURE__ */ new Set();
       projectGeneration = 0;
       cachedProjectAnalysis;
       openDocument(document, context) {
@@ -33370,6 +33518,7 @@ var init_service = __esm({
           );
         }
         const previous = this.documents.get(document.uri);
+        if (previous) this.specSnapshots.delete(previous);
         this.documents.set(document.uri, {
           document,
           context,
@@ -33395,6 +33544,7 @@ var init_service = __esm({
         state.document = document;
         const previousProjectIndex = state.snapshot?.project;
         state.snapshot = void 0;
+        this.specSnapshots.delete(state);
         if (!isProjectDocument(document, state.context) && state.context.projectSourceKind !== "spec") {
           state.snapshot = createSnapshot(
             document,
@@ -33426,6 +33576,7 @@ var init_service = __esm({
         }
         state.context = context;
         state.contextKey = contextKey;
+        this.specSnapshots.delete(state);
         state.snapshot = isProjectDocument(state.document, context) || context.projectSourceKind === "spec" ? void 0 : createSnapshot(state.document, context);
         state.validationGeneration++;
         if (isProjectDocument(state.document, context))
@@ -33434,9 +33585,11 @@ var init_service = __esm({
       closeDocument(uri) {
         const state = this.documents.get(uri);
         this.documents.delete(uri);
+        if (state) this.specSnapshots.delete(state);
         if (state && isProjectDocument(state.document, state.context)) {
           this.invalidateProjectAnalysis();
         }
+        if (this.documents.size === 0) this.cachedProjectAnalysis = void 0;
       }
       hasDocument(uri) {
         return this.documents.has(uri);
@@ -33674,7 +33827,8 @@ var init_service = __esm({
               kind: document.languageId === "neoflow" ? "flow" : context.kind === "migration" ? "migration" : "definition",
               text: document.text
             } : null
-          ).filter((input) => input !== null)
+          ).filter((input) => input !== null),
+          this.cachedProjectAnalysis?.analysis.documents
         );
         this.cachedProjectAnalysis = {
           generation: this.projectGeneration,
@@ -33684,11 +33838,8 @@ var init_service = __esm({
       }
       invalidateProjectAnalysis() {
         this.projectGeneration++;
-        this.cachedProjectAnalysis = void 0;
-        for (const state of this.documents.values()) {
-          if (state.context.projectSourceKind === "spec")
-            state.snapshot = void 0;
-        }
+        for (const state of this.specSnapshots) state.snapshot = void 0;
+        this.specSnapshots.clear();
       }
       projectReferences(document, position, includeDeclaration) {
         const token = projectTokenAt(document, position);
@@ -33740,6 +33891,8 @@ var init_service = __esm({
             project: this.projectAnalysis().project
           }) : state.context
         );
+        if (state.context.projectSourceKind === "spec")
+          this.specSnapshots.add(state);
         return state.snapshot;
       }
       requireState(uri) {
@@ -34012,6 +34165,7 @@ var init_src = __esm({
     init_project_source_construction_quick_fixes();
     init_project_source_manifest();
     init_project_source_variants();
+    init_project_source_tile();
     init_project_source_parameter_defaults();
     init_project_source_settlement();
     init_project_source_parser();
@@ -44182,36 +44336,36 @@ var MemberKind;
 var init_member_kind_enum = __esm({
   "../src/models/members/member-kind-enum.ts"() {
     "use strict";
-    MemberKind = /* @__PURE__ */ ((MemberKind15) => {
-      MemberKind15[MemberKind15["Null"] = 0] = "Null";
-      MemberKind15[MemberKind15["Bool"] = 1] = "Bool";
-      MemberKind15[MemberKind15["Int"] = 2] = "Int";
-      MemberKind15[MemberKind15["String"] = 3] = "String";
-      MemberKind15[MemberKind15["Float"] = 4] = "Float";
-      MemberKind15[MemberKind15["Dictionary"] = 5] = "Dictionary";
-      MemberKind15[MemberKind15["List"] = 6] = "List";
-      MemberKind15[MemberKind15["Class"] = 7] = "Class";
-      MemberKind15[MemberKind15["Enum"] = 8] = "Enum";
-      MemberKind15[MemberKind15["Lookup"] = 9] = "Lookup";
-      MemberKind15[MemberKind15["NSProperty"] = 10] = "NSProperty";
-      MemberKind15[MemberKind15["Sprite"] = 11] = "Sprite";
-      MemberKind15[MemberKind15["Audio"] = 12] = "Audio";
-      MemberKind15[MemberKind15["Function"] = 13] = "Function";
-      MemberKind15[MemberKind15["Vector2"] = 14] = "Vector2";
-      MemberKind15[MemberKind15["Vector2Int"] = 15] = "Vector2Int";
-      MemberKind15[MemberKind15["Vector3"] = 16] = "Vector3";
-      MemberKind15[MemberKind15["Vector3Int"] = 17] = "Vector3Int";
-      MemberKind15[MemberKind15["DialogueLookup"] = 18] = "DialogueLookup";
-      MemberKind15[MemberKind15["Color"] = 19] = "Color";
-      MemberKind15[MemberKind15["Decimal"] = 20] = "Decimal";
-      MemberKind15[MemberKind15["Generic"] = 21] = "Generic";
-      MemberKind15[MemberKind15["Interface"] = 22] = "Interface";
-      MemberKind15[MemberKind15["NSFunction"] = 23] = "NSFunction";
-      MemberKind15[MemberKind15["FunctionRef"] = 24] = "FunctionRef";
-      MemberKind15[MemberKind15["NSDelegate"] = 25] = "NSDelegate";
-      MemberKind15[MemberKind15["NSAction"] = 26] = "NSAction";
-      MemberKind15[MemberKind15["Variant"] = 27] = "Variant";
-      return MemberKind15;
+    MemberKind = /* @__PURE__ */ ((MemberKind16) => {
+      MemberKind16[MemberKind16["Null"] = 0] = "Null";
+      MemberKind16[MemberKind16["Bool"] = 1] = "Bool";
+      MemberKind16[MemberKind16["Int"] = 2] = "Int";
+      MemberKind16[MemberKind16["String"] = 3] = "String";
+      MemberKind16[MemberKind16["Float"] = 4] = "Float";
+      MemberKind16[MemberKind16["Dictionary"] = 5] = "Dictionary";
+      MemberKind16[MemberKind16["List"] = 6] = "List";
+      MemberKind16[MemberKind16["Class"] = 7] = "Class";
+      MemberKind16[MemberKind16["Enum"] = 8] = "Enum";
+      MemberKind16[MemberKind16["Lookup"] = 9] = "Lookup";
+      MemberKind16[MemberKind16["NSProperty"] = 10] = "NSProperty";
+      MemberKind16[MemberKind16["Sprite"] = 11] = "Sprite";
+      MemberKind16[MemberKind16["Audio"] = 12] = "Audio";
+      MemberKind16[MemberKind16["Function"] = 13] = "Function";
+      MemberKind16[MemberKind16["Vector2"] = 14] = "Vector2";
+      MemberKind16[MemberKind16["Vector2Int"] = 15] = "Vector2Int";
+      MemberKind16[MemberKind16["Vector3"] = 16] = "Vector3";
+      MemberKind16[MemberKind16["Vector3Int"] = 17] = "Vector3Int";
+      MemberKind16[MemberKind16["DialogueLookup"] = 18] = "DialogueLookup";
+      MemberKind16[MemberKind16["Color"] = 19] = "Color";
+      MemberKind16[MemberKind16["Decimal"] = 20] = "Decimal";
+      MemberKind16[MemberKind16["Generic"] = 21] = "Generic";
+      MemberKind16[MemberKind16["Interface"] = 22] = "Interface";
+      MemberKind16[MemberKind16["NSFunction"] = 23] = "NSFunction";
+      MemberKind16[MemberKind16["FunctionRef"] = 24] = "FunctionRef";
+      MemberKind16[MemberKind16["NSDelegate"] = 25] = "NSDelegate";
+      MemberKind16[MemberKind16["NSAction"] = 26] = "NSAction";
+      MemberKind16[MemberKind16["Variant"] = 27] = "Variant";
+      return MemberKind16;
     })(MemberKind || {});
   }
 });
@@ -52159,6 +52313,18 @@ function constructionMembers(classId, context) {
   }
   return result;
 }
+function createMemberDefaultConstructionChecker(document) {
+  const context = contextFor(document);
+  return (member, genericEnv = /* @__PURE__ */ new Map()) => {
+    const previousEnv = context.env;
+    context.env = genericEnv;
+    try {
+      return defaultSettlesConstruction(member, context, /* @__PURE__ */ new Set());
+    } finally {
+      context.env = previousEnv;
+    }
+  };
+}
 function storedValueSettlesConstruction(member, sourceValue, document, genericEnv) {
   return valueSettlesConstruction(
     member,
@@ -53360,18 +53526,27 @@ function storedLeafExpectation(kind) {
   return "canonical decimal string";
 }
 function* storedValueChildReferences(args) {
+  for (const child of storedValueChildEntries(args)) {
+    if (typeof child.value !== "string") continue;
+    yield {
+      memberId: child.memberId,
+      valueId: child.value,
+      pathSuffix: child.pathSuffix
+    };
+  }
+}
+function* storedValueChildEntries(args) {
   const entryMemberId = args.member.entryMemberId;
   if (args.member.kind === 6 /* List */ && typeof entryMemberId === "string") {
     const ids = args.member.listKind === 1 /* Unordered */ && args.unorderedValueIds !== void 0 ? args.unorderedValueIds : Array.isArray(args.body) ? args.body : [];
     let pathIndex = 0;
     for (const valueId of ids) {
-      if (typeof valueId !== "string") continue;
       yield {
         memberId: entryMemberId,
-        valueId,
+        value: valueId,
         pathSuffix: `[${pathIndex}]`
       };
-      pathIndex++;
+      if (typeof valueId === "string") pathIndex++;
     }
     return;
   }
@@ -53380,16 +53555,14 @@ function* storedValueChildReferences(args) {
     for (const key in body) {
       if (!Object.hasOwn(body, key)) continue;
       const valueId = body[key];
-      if (typeof valueId !== "string") continue;
-      yield { memberId: entryMemberId, valueId, pathSuffix: `.${key}` };
+      yield { memberId: entryMemberId, value: valueId, pathSuffix: `.${key}` };
     }
     return;
   }
   if (args.member.kind === 7 /* Class */ && body !== null) {
     for (const { schemaKey, memberId } of args.classFields ?? []) {
       const valueId = body[schemaKey];
-      if (typeof valueId !== "string") continue;
-      yield { memberId, valueId, pathSuffix: `.${schemaKey}` };
+      yield { memberId, value: valueId, pathSuffix: `.${schemaKey}` };
     }
   }
 }
@@ -53450,7 +53623,8 @@ function createDefaultValueResolutionCache() {
     materializationPlanByClassAndEnvironment: /* @__PURE__ */ new Map(),
     resolvedMemberById: /* @__PURE__ */ new Map(),
     storedSchemaByClassId: /* @__PURE__ */ new Map(),
-    validatedInitializerContainers: /* @__PURE__ */ new WeakSet()
+    validatedInitializerContainers: /* @__PURE__ */ new WeakSet(),
+    memberDefaultConstructionChecker: null
   };
 }
 function withIndexedDefaultValueDocument(document, options = {}) {
@@ -53504,6 +53678,13 @@ function withIndexedDefaultValueDocument(document, options = {}) {
       cache.validatedInitializerContainers.add(value);
       return true;
     },
+    memberDefaultSettlesConstruction: (member, environment) => {
+      cache.memberDefaultConstructionChecker ??= createMemberDefaultConstructionChecker({
+        ...document,
+        constructors: document.constructors ?? []
+      });
+      return cache.memberDefaultConstructionChecker(member, environment);
+    },
     createValueRow: options.createValueRow ?? document.createValueRow
   };
   indexed.storedInstanceMaterializationPlan = (classId, environment) => {
@@ -53549,6 +53730,10 @@ function directScalarDefaultBody(document, member) {
   return { value: body.value, classId: body.classId };
 }
 function buildDefaultClassMaterializationPlan(document, classId, instanceEnv) {
+  const settlesConstruction = document.memberDefaultSettlesConstruction ?? createMemberDefaultConstructionChecker({
+    ...document,
+    constructors: document.constructors ?? []
+  });
   const merged = document.storedInstanceSchema?.(classId) ?? mergeStoredInstanceSchema(classId, document.classes, document.members);
   return merged.flatMap((entry) => {
     if (entry.memberId === null) return [];
@@ -53564,6 +53749,7 @@ function buildDefaultClassMaterializationPlan(document, classId, instanceEnv) {
       {
         schemaKey: entry.schemaKey,
         member,
+        defaultSettlesConstruction: settlesConstruction(member, instanceEnv),
         directScalarBody: directScalarDefaultBody(document, member)
       }
     ];
@@ -53772,6 +53958,7 @@ function buildDefaultMemberValue(args) {
     for (const {
       schemaKey,
       member: resolvedChildMember,
+      defaultSettlesConstruction: defaultSettlesConstruction2,
       directScalarBody
     } of member.payload === 1 /* Partial */ ? [] : materializationPlan) {
       if (storageKeyReferencesParentClass(
@@ -53787,6 +53974,7 @@ function buildDefaultMemberValue(args) {
         args.constructorRoot,
         schemaKey,
         resolvedChildMember,
+        defaultSettlesConstruction2,
         documentHasInitValueContent(
           args.document,
           resolvedChildMember.defaultValue
@@ -53794,7 +53982,7 @@ function buildDefaultMemberValue(args) {
       )) {
         continue;
       }
-      if (isRequiredMember2(resolvedChildMember) && resolvedChildMember.defaultValue == null && !(isMemberClassBase(resolvedChildMember) && resolvedChildMember.payload === 1 /* Partial */)) {
+      if (isRequiredMember2(resolvedChildMember) && !defaultSettlesConstruction2 && !(isMemberClassBase(resolvedChildMember) && resolvedChildMember.payload === 1 /* Partial */)) {
         if (args.constructorRoot?.runsMemberInitializers === true) continue;
         if (args.constructorRoot?.omitMissingRequired === true) continue;
         throw new Error(
@@ -53804,6 +53992,7 @@ function buildDefaultMemberValue(args) {
       if (!shouldMaterializeChildDefaultForRoot(
         args.constructorRoot,
         resolvedChildMember,
+        defaultSettlesConstruction2,
         documentHasInitValueContent(
           args.document,
           resolvedChildMember.defaultValue
@@ -54309,18 +54498,18 @@ function shouldMaterializeConstructorChildDefault(member, isInitializer = isInit
   if (!isRequiredMember2(member)) return false;
   return shouldMaterializeChildDefault(member);
 }
-function skipProvidedConstructorSchemaKey(constructorRoot, schemaKey, member, isInitializer = isInitValueContent(member.defaultValue)) {
+function skipProvidedConstructorSchemaKey(constructorRoot, schemaKey, member, defaultSettlesConstruction2, isInitializer = isInitValueContent(member.defaultValue)) {
   if (constructorRoot === void 0) return false;
   if (!constructorRoot.providedSchemaKeys.has(schemaKey)) return false;
   if (constructorRoot.runsMemberInitializers !== true) {
     return !isInitializer;
   }
-  return member.defaultValue == null;
+  return !isInitializer && !defaultSettlesConstruction2;
 }
-function shouldMaterializeChildDefaultForRoot(constructorRoot, member, isInitializer = isInitValueContent(member.defaultValue)) {
+function shouldMaterializeChildDefaultForRoot(constructorRoot, member, defaultSettlesConstruction2, isInitializer = isInitValueContent(member.defaultValue)) {
   if (constructorRoot === void 0)
     return shouldMaterializeChildDefault(member);
-  if (constructorRoot.omitMissingRequired === true && isRequiredMember2(member) && member.defaultValue == null) {
+  if (constructorRoot.omitMissingRequired === true && !defaultSettlesConstruction2) {
     return false;
   }
   if (constructorRoot.runsMemberInitializers === true) {
@@ -67987,25 +68176,31 @@ function clearNeoScriptBodyCompileCache() {
   neoScriptBodyCompileCache.clear();
 }
 function createNeoScriptCompilationProject(ctx) {
-  const members = [...ctx.members];
-  const membersById = new Map(members.map((member) => [member.id, member]));
-  return createNeoScriptProject({
-    vm: {
-      project: ctx.project,
-      projectFiles: [...ctx.projectFiles ?? []],
-      members,
-      classes: [...ctx.classes],
-      enums: [...ctx.enums],
-      interfaces: [...ctx.interfaces ?? []],
-      databaseVM: {
-        memberById: (id2) => membersById.get(id2) ?? null
-      }
-    },
+  const vm = createAnalyzerProject(ctx);
+  const project = createNeoScriptProject({
+    vm,
     thisClass: null,
     ...ctx.constructors ? { constructors: ctx.constructors } : {},
     ...ctx.variants ? { variants: ctx.variants } : {},
     ...ctx.variantFolders ? { variantFolders: ctx.variantFolders } : {}
   });
+  analyzerProjects.set(project, vm);
+  return project;
+}
+function createAnalyzerProject(ctx) {
+  const members = [...ctx.members];
+  const membersById = new Map(members.map((member) => [member.id, member]));
+  return {
+    project: ctx.project,
+    projectFiles: [...ctx.projectFiles ?? []],
+    members,
+    classes: [...ctx.classes],
+    enums: [...ctx.enums],
+    interfaces: [...ctx.interfaces ?? []],
+    databaseVM: {
+      memberById: (id2) => membersById.get(id2) ?? null
+    }
+  };
 }
 function compileNSGetter(code, ctx) {
   return compileStrict(
@@ -68139,7 +68334,8 @@ function compileStrict(code, context) {
       version: 1,
       text: code
     },
-    context
+    context,
+    compilationProjectIndex(context.project)
   );
   if ("getter" in compiled) {
     throw new Error(
@@ -68161,21 +68357,17 @@ function compilationProjectIdentity(project) {
   neoScriptProjectIdentityCache.set(project, identity2);
   return identity2;
 }
+function compilationProjectIndex(project) {
+  const cached = neoScriptProjectIndexes.get(project);
+  if (cached !== void 0) return cached;
+  const index = createProjectIndex(project);
+  neoScriptProjectIndexes.set(project, index);
+  return index;
+}
 function createContext(ctx, options) {
-  const members = [...ctx.members];
-  const membersById = new Map(members.map((member) => [member.id, member]));
+  const prepared = ctx.compilationProject === void 0 ? void 0 : analyzerProjects.get(ctx.compilationProject);
   const analyzer = {
-    vm: {
-      project: ctx.project,
-      projectFiles: [...ctx.projectFiles ?? []],
-      members,
-      classes: [...ctx.classes],
-      enums: [...ctx.enums],
-      interfaces: [...ctx.interfaces ?? []],
-      databaseVM: {
-        memberById: (id2) => membersById.get(id2) ?? null
-      }
-    },
+    vm: prepared ?? createAnalyzerProject(ctx),
     thisClass: ctx.thisClass,
     ...ctx.valueAliases ? { valueAliases: ctx.valueAliases } : {},
     ...ctx.constructors ? { constructors: ctx.constructors } : {},
@@ -68202,7 +68394,7 @@ function createContext(ctx, options) {
     staticMember: ctx.staticMember === true
   };
 }
-var NEOSCRIPT_BODY_COMPILE_CACHE_LIMIT, neoScriptBodyCompileCache, neoScriptProjectIdentityCache, nextNeoScriptProjectIdentity;
+var NEOSCRIPT_BODY_COMPILE_CACHE_LIMIT, neoScriptBodyCompileCache, neoScriptProjectIdentityCache, neoScriptProjectIndexes, analyzerProjects, nextNeoScriptProjectIdentity;
 var init_compile = __esm({
   "../src/database/neoscript/compile.ts"() {
     "use strict";
@@ -68211,6 +68403,8 @@ var init_compile = __esm({
     NEOSCRIPT_BODY_COMPILE_CACHE_LIMIT = 1024;
     neoScriptBodyCompileCache = /* @__PURE__ */ new Map();
     neoScriptProjectIdentityCache = /* @__PURE__ */ new WeakMap();
+    neoScriptProjectIndexes = /* @__PURE__ */ new WeakMap();
+    analyzerProjects = /* @__PURE__ */ new WeakMap();
     nextNeoScriptProjectIdentity = 1;
   }
 });
@@ -84081,6 +84275,108 @@ var init_project_record_migrations = __esm({
   }
 });
 
+// ../src/database/member-default-reference-ids.ts
+async function loadMemberDefaultValueClosure(args) {
+  const classes = args.classes.filter(isNeoSchemaClass);
+  const members = args.members.filter(isAnyMember);
+  const index = projectSchemaIndexFor({ classes, members });
+  const classSchemas = /* @__PURE__ */ new Map();
+  const defaultEnvironments = /* @__PURE__ */ new Map();
+  const defaultEnvironment = (classId) => {
+    let env = defaultEnvironments.get(classId);
+    if (env === void 0) {
+      env = resolveInstanceEnv(classId, void 0, classes);
+      defaultEnvironments.set(classId, env);
+    }
+    return env;
+  };
+  const pending = [];
+  const visited = /* @__PURE__ */ new Set();
+  const closure = /* @__PURE__ */ new Map();
+  const visit = (rawMember, source, ambientEnv) => {
+    if (!isLiteralValueContent(source)) return;
+    if (typeof source.value !== "object" || source.value === null || Object.keys(source.value).length === 0)
+      return;
+    const stamp = "genericBindings" in source ? source.genericBindings : void 0;
+    const withStamp = (base) => {
+      if (typeof stamp !== "object" || stamp === null) return base;
+      const stamped = new Map(base);
+      for (const [parameterId, memberId] of Object.entries(stamp)) {
+        if (typeof memberId === "string")
+          stamped.set(parameterId, { kind: "member", memberId });
+      }
+      return stamped;
+    };
+    let env = withStamp(ambientEnv);
+    const member = substituteMember(rawMember, env, members);
+    let classFields;
+    if (isMemberClassBase(member)) {
+      const classId = source.classId ?? member.classId;
+      classFields = classSchemas.get(classId);
+      if (classFields === void 0) {
+        classFields = mergeStoredInstanceSchema(classId, classes, members);
+        classSchemas.set(classId, classFields);
+      }
+      env = withStamp(
+        member.classArguments == null ? defaultEnvironment(classId) : resolveInstanceEnv(classId, member.classArguments, classes)
+      );
+    }
+    for (const child of storedValueChildEntries({
+      member,
+      body: source.value,
+      classFields
+    })) {
+      const childMember = index.member(child.memberId);
+      if (childMember === void 0) continue;
+      if (typeof child.value === "string")
+        pending.push({ id: child.value, member: childMember, env });
+      else if (isPackedValueEnvelope(child.value))
+        visit(childMember, child.value["~packed"], env);
+    }
+  };
+  for (const member of members) {
+    if (member.defaultValue === void 0) continue;
+    const placement = index.firstSchemaPlacement(member.id);
+    const env = placement === null ? /* @__PURE__ */ new Map() : defaultEnvironment(placement.ownerClass.id);
+    visit(member, member.defaultValue, env);
+  }
+  while (pending.length > 0) {
+    const missing = [];
+    while (pending.length > 0 && missing.length < 128) {
+      const item = pending.pop();
+      if (visited.has(item.id)) continue;
+      visited.add(item.id);
+      const row = args.valuesById.get(item.id);
+      if (row === void 0) missing.push(item);
+      else {
+        closure.set(item.id, row);
+        visit(item.member, args.data(row), item.env);
+      }
+    }
+    if (missing.length === 0) continue;
+    const loaded = await args.loadValues(missing.map((item) => item.id));
+    for (const item of missing) {
+      const row = loaded.get(item.id);
+      if (row === void 0) continue;
+      closure.set(item.id, row);
+      visit(item.member, args.data(row), item.env);
+    }
+  }
+  return closure;
+}
+var init_member_default_reference_ids = __esm({
+  "../src/database/member-default-reference-ids.ts"() {
+    "use strict";
+    init_classes();
+    init_inheritance();
+    init_generics();
+    init_members();
+    init_packed_value_encoding();
+    init_stored_value_shape();
+    init_project_schema_index();
+  }
+});
+
 // ../src/database/project-document-read.ts
 var project_document_read_exports = {};
 __export(project_document_read_exports, {
@@ -84090,6 +84386,7 @@ __export(project_document_read_exports, {
   fetchProjectDocumentRawChunked: () => fetchProjectDocumentRawChunked,
   fetchProjectDocumentRawChunkedOnce: () => fetchProjectDocumentRawChunkedOnce,
   fetchProjectDocumentSnapshots: () => fetchProjectDocumentSnapshots,
+  fetchProjectDocumentValueRecords: () => fetchProjectDocumentValueRecords,
   readArrayField: () => readArrayField,
   readProjectDocument: () => readProjectDocument,
   readProjectDocumentContentHashHeads: () => readProjectDocumentContentHashHeads,
@@ -84167,7 +84464,8 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
       const pageResult = await runner.fetchManifestPage(
         { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor: null },
         mapKey,
-        readBase
+        readBase,
+        "omit"
       );
       if (pageResult === null) {
         throw new Error(
@@ -84179,8 +84477,34 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
       await rememberRecords(page.records);
       await fetchRemainingPages(mapKey, page.continueCursor);
     }
-    const records2 = [...recordsByKey.values()];
     const snapshotsById = await snapshots.finish();
+    if (options.mapKeys !== void 0 && !options.mapKeys.includes("all")) {
+      const members = [];
+      const classes = [];
+      const valuesById = /* @__PURE__ */ new Map();
+      for (const snapshot of snapshotsById.values()) {
+        if (snapshot.recordKind === "member") members.push(snapshot.data);
+        if (snapshot.recordKind === "class") classes.push(snapshot.data);
+        if (snapshot.recordKind === "value")
+          valuesById.set(snapshot.recordId, snapshot);
+      }
+      const defaults = await loadMemberDefaultValueClosure({
+        classes,
+        members,
+        valuesById,
+        data: (snapshot) => snapshot.data,
+        loadValues: (ids) => fetchProjectDocumentValueRecords(runner, ids, readBase)
+      });
+      for (const snapshot of defaults.values()) {
+        snapshotsById.set(snapshot.id, snapshot);
+        recordsByKey.set(`value ${snapshot.recordId}`, {
+          recordKind: "value",
+          recordId: snapshot.recordId,
+          snapshotId: snapshot.id
+        });
+      }
+    }
+    const records2 = [...recordsByKey.values()];
     await runner.validateReadBase(readBase);
     return assembleProjectDocumentRaw({
       version: metadata.version,
@@ -84207,47 +84531,95 @@ async function fetchProjectDocumentPartitionRecords(runner, mapKey, readBase) {
     );
   }
   const recordsByKey = /* @__PURE__ */ new Map();
+  const snapshots = createProjectDocumentSnapshotLoader(
+    (ids) => fetchScopedSnapshotBatch(runner, ids, readBase)
+  );
+  try {
+    let cursor = null;
+    do {
+      const pageResult = await runner.fetchManifestPage(
+        { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor },
+        mapKey,
+        readBase,
+        "omit"
+      );
+      if (pageResult === null) {
+        throw new Error(
+          `Convex project document manifest returned null for partition "${mapKey}".`
+        );
+      }
+      const page = readProjectDocumentManifestPage(pageResult);
+      assertProjectReadBase(readBase, page.readBase);
+      for (const record4 of page.records) {
+        recordsByKey.set(`${record4.recordKind} ${record4.recordId}`, record4);
+      }
+      await snapshots.enqueue(page.records.map((record4) => record4.snapshotId));
+      cursor = page.continueCursor;
+    } while (cursor !== null);
+    const snapshotsById = await snapshots.finish();
+    await runner.validateReadBase(readBase);
+    return [...recordsByKey.values()].map((record4) => {
+      const snapshot = snapshotsById.get(record4.snapshotId);
+      if (snapshot === void 0) {
+        throw new Error(
+          `Partition "${mapKey}" snapshot "${record4.snapshotId}" referenced by the manifest was not returned by any snapshot batch.`
+        );
+      }
+      return {
+        recordKind: record4.recordKind,
+        recordId: record4.recordId,
+        deleted: false,
+        data: snapshot.data,
+        contentHash: snapshot.contentHash
+      };
+    });
+  } finally {
+    await snapshots.stop();
+  }
+}
+async function fetchProjectDocumentValueRecords(runner, valueIds, readBase) {
+  if (runner.fetchValueHeadsPage === void 0) {
+    throw new Error(
+      "Partition-scoped document reads require a value-head reader for member defaults."
+    );
+  }
+  const values = /* @__PURE__ */ new Map();
   let cursor = null;
   do {
-    const pageResult = await runner.fetchManifestPage(
-      { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor },
-      mapKey,
-      readBase
-    );
-    if (pageResult === null) {
+    const page = await runner.fetchValueHeadsPage(valueIds, cursor, readBase);
+    if (!isObject4(page)) throw new Error("Value-head page must be an object.");
+    const revision = readProjectDocumentRevisionMarker({
+      documentRevision: page.documentRevision
+    });
+    if (revision === null)
+      throw new Error("Value-head page has no document revision.");
+    assertProjectReadBase(readBase, revision.readBase);
+    if (!Array.isArray(page.snapshotIds) || !page.snapshotIds.every((id2) => typeof id2 === "string"))
       throw new Error(
-        `Convex project document manifest returned null for partition "${mapKey}".`
+        "Value-head page snapshotIds must be an array of strings."
       );
-    }
-    const page = readProjectDocumentManifestPage(pageResult);
-    assertProjectReadBase(readBase, page.readBase);
-    for (const record4 of page.records) {
-      recordsByKey.set(`${record4.recordKind} ${record4.recordId}`, record4);
-    }
-    cursor = page.continueCursor;
-  } while (cursor !== null);
-  const records2 = [...recordsByKey.values()];
-  const snapshotIds = [...new Set(records2.map((record4) => record4.snapshotId))];
-  const snapshotsById = await fetchProjectDocumentSnapshots(
-    (ids) => fetchScopedSnapshotBatch(runner, ids, readBase),
-    snapshotIds
-  );
-  await runner.validateReadBase(readBase);
-  return records2.map((record4) => {
-    const snapshot = snapshotsById.get(record4.snapshotId);
-    if (snapshot === void 0) {
+    if (page.continueCursor !== null && typeof page.continueCursor !== "string")
       throw new Error(
-        `Partition "${mapKey}" snapshot "${record4.snapshotId}" referenced by the manifest was not returned by any snapshot batch.`
+        "Value-head page continueCursor must be a string or null."
       );
+    const loaded = await fetchProjectDocumentSnapshots(
+      (ids) => fetchScopedSnapshotBatch(runner, ids, readBase),
+      page.snapshotIds
+    );
+    for (const snapshot of loaded.values()) {
+      if (snapshot.recordKind !== "value")
+        throw new Error("Value-head page returned a non-value snapshot.");
+      if (snapshot.deleted)
+        throw new Error("Value-head page returned a deleted snapshot.");
+      if (!valueIds.includes(snapshot.recordId))
+        throw new Error(
+          `Value-head page returned unrequested value "${snapshot.recordId}".`
+        );
+      values.set(snapshot.recordId, snapshot);
     }
-    return {
-      recordKind: record4.recordKind,
-      recordId: record4.recordId,
-      deleted: false,
-      data: snapshot.data,
-      contentHash: snapshot.contentHash
-    };
-  });
+    cursor = page.continueCursor;
+  } while (cursor !== null);
+  return values;
 }
 function assertProjectReadBase(expected, actual) {
   if (!projectReadBasesMatch(expected, actual))
@@ -84817,8 +85189,9 @@ var init_project_document_read = __esm({
     init_projectDocumentDialogueMaterialization();
     init_projectRecordBuckets();
     init_project_record_migrations();
+    init_member_default_reference_ids();
     DOCUMENT_MANIFEST_PAGE_SIZE = 2048;
-    DOCUMENT_SNAPSHOT_FETCH_CHUNK_SIZE = 512;
+    DOCUMENT_SNAPSHOT_FETCH_CHUNK_SIZE = 128;
     DOCUMENT_SNAPSHOT_FETCH_CONCURRENCY = 4;
   }
 });
@@ -113956,7 +114329,18 @@ function animationConstructorProjectionTargetValueIds(context, classId, value) {
   }
   return targetIds;
 }
-function rowBackedDefaultBody(member, isPulledValueRow) {
+function isTileInstanceClass(classId, classes) {
+  const visited = /* @__PURE__ */ new Set();
+  while (typeof classId === "string" && !visited.has(classId)) {
+    visited.add(classId);
+    const schemaClass2 = classes.get(classId);
+    if (isObjectRecord2(schemaClass2?.system) && schemaClass2.system.worldKind === "tileInstance")
+      return true;
+    classId = schemaClass2?.extendsClassId;
+  }
+  return false;
+}
+function rowBackedDefaultBody(member, isPulledValueRow, classes) {
   if (member.modifier === 3) return null;
   const defaultValue = member.defaultValue;
   if (!isObjectRecord2(defaultValue)) return null;
@@ -113965,7 +114349,10 @@ function rowBackedDefaultBody(member, isPulledValueRow) {
     (child) => typeof child === "string" && isPulledValueRow(child)
   );
   if (member.kind === MEMBER_KIND_CLASS2 && isObjectRecord2(body)) {
-    const children = Object.values(body);
+    const children = isTileInstanceClass(
+      defaultValue.classId ?? member.classId,
+      classes
+    ) ? Object.entries(body).filter(([key]) => key !== "assetClassId" && key !== "variantId").map(([, value]) => value) : Object.values(body);
     return referencesRows(children) ? { kind: "class", body } : null;
   }
   if (member.kind === MEMBER_KIND_LIST2 && member.listKind !== "unordered" && Array.isArray(body)) {
@@ -113981,15 +114368,18 @@ function rowBackedDefaultBody(member, isPulledValueRow) {
 }
 function rowBackedDefaultMemberIdsV4(state) {
   const values = /* @__PURE__ */ new Set();
+  const classes = /* @__PURE__ */ new Map();
   for (const record4 of Object.values(state)) {
     if (record4.recordKind === "value") values.add(record4.recordId);
+    if (record4.recordKind === "class" && isObjectRecord2(record4.data))
+      classes.set(record4.recordId, record4.data);
   }
   const result = /* @__PURE__ */ new Set();
   for (const record4 of Object.values(state)) {
     if (record4.recordKind !== "member" || !isObjectRecord2(record4.data)) {
       continue;
     }
-    if (rowBackedDefaultBody(record4.data, (id2) => values.has(id2)) !== null) {
+    if (rowBackedDefaultBody(record4.data, (id2) => values.has(id2), classes) !== null) {
       result.add(record4.recordId);
     }
   }
@@ -114023,7 +114413,11 @@ function emitMemberDefaultSourcesV4(records2, manifest) {
       context.localizedTextIds.clear();
       continue;
     }
-    const backed = rowBackedDefaultBody(member, (id2) => context.values.has(id2));
+    const backed = rowBackedDefaultBody(
+      member,
+      (id2) => context.values.has(id2),
+      context.manifestClasses
+    );
     if (backed === null) continue;
     const visited = /* @__PURE__ */ new Set();
     const environment = declaringClassGenericEnvironment(context, member);
@@ -114750,7 +115144,11 @@ function lowerMemberDefaultSourcesV4(state, analysis, manifest, options = {}) {
         });
         continue;
       }
-      const backed = baseData3 === null || requiresEvaluation ? null : rowBackedDefaultBody(baseData3, (id2) => pulledValueIds.has(id2));
+      const backed = baseData3 === null || requiresEvaluation ? null : rowBackedDefaultBody(
+        baseData3,
+        (id2) => pulledValueIds.has(id2),
+        context.classes
+      );
       if (backed !== null && baseData3 !== null) {
         const existingReconstructedKeys = new Set(context.reconstructed.keys());
         const existingPendingValueIds = new Set(context.pendingValues.keys());
@@ -115349,9 +115747,11 @@ function classGenericEnvironment(context, classId) {
 function lowerRowBackedDefault(context, member, backed, baseData3, binding) {
   const baseDefault = isObjectRecord2(baseData3.defaultValue) ? baseData3.defaultValue : {};
   const storedClassId = stringOrNull2(baseDefault.classId);
-  const expression = annotatedValue(
-    parseCachedInitializer(context.parsedInitializers, binding.initializer)
-  ).expression;
+  const sourceExpression = parseCachedInitializer(
+    context.parsedInitializers,
+    binding.initializer
+  );
+  const expression = annotatedValue(sourceExpression).expression;
   const bindingEnvironment = bindingGenericEnvironment(context, binding);
   if (member.kind === "class" && backed.kind === "class") {
     if (expression.kind === "litNull") {
@@ -115390,6 +115790,21 @@ function lowerRowBackedDefault(context, member, backed, baseData3, binding) {
     );
     const baseBody = backed.body;
     const body = {};
+    if (isTileInstanceClass(classId, context.classes) && isObjectRecord2(baseBody)) {
+      for (const key of ["assetClassId", "assetValueId", "variantId"]) {
+        if (baseBody[key] !== void 0) body[key] = baseBody[key];
+      }
+      if (typeof body.assetValueId === "string") {
+        retainStoredValueSubgraph(
+          context,
+          body.assetValueId,
+          binding.source,
+          /* @__PURE__ */ new Set(),
+          null,
+          environment
+        );
+      }
+    }
     lowerConstructorProjections(
       context,
       schemaClass2,
@@ -115449,7 +115864,10 @@ function lowerRowBackedDefault(context, member, backed, baseData3, binding) {
       );
     }
     return {
-      value: body,
+      value: applyTileAnnotation(context, sourceExpression, {
+        classId,
+        value: body
+      }).value,
       classId: classId === currentClassId ? storedClassId : classId
     };
   }
@@ -115815,7 +116233,6 @@ function preserveReboundValue(context, currentValueId, nextValueId, binding) {
   );
 }
 function lowerStaticSeed(context, member, sourceExpression, source, valueId) {
-  const expression = annotatedValue(sourceExpression).expression;
   const rows = /* @__PURE__ */ new Map();
   const localizedTexts = /* @__PURE__ */ new Map();
   const existingBindingMemberIds = new Set(
@@ -115826,7 +116243,7 @@ function lowerStaticSeed(context, member, sourceExpression, source, valueId) {
   const root = lowerSeedRow(
     context,
     member,
-    expression,
+    sourceExpression,
     source,
     valueId,
     source.label,
@@ -115880,7 +116297,8 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
       localizedTexts,
       containerId,
       inheritedEnvironment,
-      authoredSlice
+      authoredSlice,
+      sourceExpression
     );
   }
   if (!isStoredCallableLiteral(resolvedMember.kind, expression) && memberInitializerRequiresEvaluation(
@@ -115889,6 +116307,11 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
     expression,
     source
   )) {
+    if (tileAssetAnnotation(sourceExpression) !== null) {
+      throw new Error(
+        "@tile requires a literal placement construction. Construct NeoTileInstance directly and assign its members in the initializer."
+      );
+    }
     const unattachedId = annotated.id === null ? unattachedAuthoredRowId(authoredSlice) : null;
     if (unattachedId !== null) {
       throw new Error(
@@ -116204,6 +116627,10 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
     value = lowered.value;
     classId = typeof lowered.classId === "string" ? lowered.classId : null;
   }
+  value = applyTileAnnotation(context, sourceExpression, {
+    classId,
+    value
+  }).value;
   const row = {
     nodeType: "literal",
     id: valueId,
@@ -116288,7 +116715,7 @@ function structurallyConstructedClassId(context, member, expression) {
   if (expression.args.length === 0) return null;
   return effective.id;
 }
-function lowerStructuralConstructionRow(context, member, expression, source, valueId, path, rows, localizedTexts, containerId, inheritedEnvironment, authoredSlice) {
+function lowerStructuralConstructionRow(context, member, expression, source, valueId, path, rows, localizedTexts, containerId, inheritedEnvironment, authoredSlice, annotatedExpression = expression) {
   const effectiveClass = constructedClass(
     context,
     member,
@@ -116416,7 +116843,10 @@ function lowerStructuralConstructionRow(context, member, expression, source, val
     nodeType: "literal",
     id: valueId,
     memberId: member.id,
-    value,
+    value: applyTileAnnotation(context, annotatedExpression, {
+      classId: effectiveClass.id,
+      value
+    }).value,
     classId: effectiveClass.id,
     constructorArgs,
     // Provenance is stamped explicitly on every construction this lowerer
@@ -116617,7 +117047,13 @@ function lowerValueRow(context, member, sourceExpression, expectedValueId, sourc
         authoredSlice,
         projectedConstructionEditable ? "reproject" : "preserve"
       );
-      addReconstructed(context, "value", expectedValueId, value2, source.source);
+      addReconstructed(
+        context,
+        "value",
+        expectedValueId,
+        applyTileAnnotation(context, sourceExpression, value2),
+        source.source
+      );
       return expectedValueId;
     }
     const literalFields = valueFileFields(base);
@@ -116641,7 +117077,13 @@ function lowerValueRow(context, member, sourceExpression, expectedValueId, sourc
     environment,
     authoredSlice
   );
-  addReconstructed(context, "value", expectedValueId, value, source.source);
+  addReconstructed(
+    context,
+    "value",
+    expectedValueId,
+    applyTileAnnotation(context, sourceExpression, value),
+    source.source
+  );
   return expectedValueId;
 }
 function lowerValueBody(context, member, expression, base, source, environment, authoredSlice) {
@@ -118894,6 +119336,38 @@ function memberPath(expression) {
   const receiver = memberPath(expression.receiver);
   return receiver === null ? null : `${receiver}.${expression.name}`;
 }
+function applyTileAnnotation(context, expression, value) {
+  const assetName = tileAssetAnnotation(expression);
+  if (assetName === null) return value;
+  const instanceBase = requiredClassByName(context, "NeoTileInstance");
+  if (typeof value.classId !== "string" || !classAssignableToClass2(context, value.classId, instanceBase.id)) {
+    throw new Error("@tile requires a NeoTileInstance construction.");
+  }
+  const asset = requiredClassByName(context, assetName);
+  const tileBase = requiredClassByName(context, "NeoTile");
+  if (!classAssignableToClass2(context, asset.id, tileBase.id)) {
+    throw new Error(`@tile asset '${assetName}' must name a tile class.`);
+  }
+  if (asset.declarationModifier === "abstract") {
+    throw new Error(
+      `@tile asset '${assetName}' must be a concrete tile class.`
+    );
+  }
+  if (asset.genericParameters.length > 0) {
+    throw new Error(
+      `@tile asset '${assetName}' must be a non-generic tile class.`
+    );
+  }
+  if (!isObjectRecord2(value.value))
+    throw new Error("@tile requires a stored placement body.");
+  const body = value.value;
+  if (body.assetClassId !== asset.id && (body.assetValueId !== void 0 || body.variantId !== void 0)) {
+    throw new Error(
+      "Cannot change a tile asset while the placement has overrides or a variant. Recreate the placement to select a different tile."
+    );
+  }
+  return { ...value, value: { ...body, assetClassId: asset.id } };
+}
 function annotatedValue(expression) {
   if (expression.kind !== "annotated") return { expression, id: null };
   const id2 = annotationId2(expression.annotations);
@@ -119135,6 +119609,27 @@ function emitValueBody(context, member, value, visited, targetTyped, environment
   );
 }
 function classValue(context, member, value, visited, targetTyped, outerEnvironment) {
+  const source = classValueBody(
+    context,
+    member,
+    value,
+    visited,
+    targetTyped,
+    outerEnvironment
+  );
+  const assetId = isObjectRecord2(value.value) ? value.value.assetClassId : void 0;
+  if (typeof assetId !== "string") return source;
+  const classId = stringOrNull2(value.classId) ?? stringField3(member, "classId");
+  if (!isTileInstanceClass(classId, context.manifestClasses)) return source;
+  const asset = context.manifestClasses.get(assetId);
+  if (asset === void 0)
+    throw new Error(
+      `Tile placement ${String(value.id)} references unknown asset class ${assetId}.`
+    );
+  return `@tile(${asset.name})
+${source}`;
+}
+function classValueBody(context, member, value, visited, targetTyped, outerEnvironment) {
   if (value.value === null) return "null";
   const partial = member.payload === 1 /* Partial */;
   const classId = stringOrNull2(value.classId) ?? stringField3(member, "classId");
@@ -129444,12 +129939,10 @@ ${blockingErrors.map((error) => `  ${error.message}`).join("\n")}`
     return await buildPostPushCompileSchema(workspace, status);
   })() : null;
   const bodySourceLocator = createNeoScriptBodySourceLocator(workspace, status);
-  if (compileSchema !== null) {
-    prepareCompleteNeoScriptBodyChanges(workspace, status, compileSchema, {
-      completeSweep: options.forceRecompile === true,
-      bodySourceLocator
-    });
-  }
+  const compileContext = compileSchema === null ? null : prepareCompleteNeoScriptBodyChanges(workspace, status, compileSchema, {
+    completeSweep: options.forceRecompile === true,
+    bodySourceLocator
+  });
   const now = Date.now();
   for (const change of status.changes) {
     if (change.nextData === void 0) continue;
@@ -129457,26 +129950,12 @@ ${blockingErrors.map((error) => `  ${error.message}`).join("\n")}`
       change.nextData = {
         ...change.nextData,
         action: compileMigrationAction(
-          compileSchema,
+          compileContext,
           change.nextData,
           bodySourceLocator
         )
       };
     }
-    if (change.recordKind === "member" && change.nextData.kind === 10) {
-      change.nextData = compileNSPropertyChange(
-        compileSchema,
-        change.nextData,
-        bodySourceLocator
-      );
-    }
-    if (change.recordKind === "member" && change.nextData.kind === 23) {
-      change.nextData = compileNSFunctionChange(
-        compileSchema,
-        change.nextData,
-        bodySourceLocator
-      );
-    }
     if (change.kind === "create") {
       change.nextData = {
         ...change.nextData,
@@ -131315,8 +131794,8 @@ async function buildPostPushCompileSchema(workspace, status) {
     variantFolders: [...bucket("variant-folder").values()]
   };
 }
-function postPushCompilerProject(schema) {
-  return {
+function createPostPushCompileContext(schema) {
+  const project = {
     project: schema.project,
     projectFiles: schema.projectFiles,
     members: schema.members,
@@ -131327,24 +131806,50 @@ function postPushCompilerProject(schema) {
     variants: schema.variants,
     variantFolders: schema.variantFolders
   };
+  const membersById = /* @__PURE__ */ new Map();
+  const classesById = /* @__PURE__ */ new Map();
+  const ownersByMemberId = /* @__PURE__ */ new Map();
+  for (const member of schema.members) {
+    if (typeof member.id !== "string") continue;
+    if (!membersById.has(member.id)) membersById.set(member.id, member);
+  }
+  for (const schemaClass2 of schema.classes) {
+    if (typeof schemaClass2.id === "string" && !classesById.has(schemaClass2.id)) {
+      classesById.set(schemaClass2.id, schemaClass2);
+    }
+    if (!isObjectRecord2(schemaClass2.schema)) continue;
+    for (const memberId of Object.values(schemaClass2.schema)) {
+      if (typeof memberId !== "string") continue;
+      if (!ownersByMemberId.has(memberId))
+        ownersByMemberId.set(memberId, schemaClass2);
+    }
+  }
+  let compilationProject;
+  return {
+    membersById,
+    classesById,
+    ownersByMemberId,
+    project() {
+      compilationProject ??= createNeoScriptCompilationProject2(project);
+      return { ...project, compilationProject };
+    }
+  };
 }
-function containingClass(schema, memberId) {
-  return schema.classes.find((schemaClass2) => {
-    const classSchema = schemaClass2.schema;
-    return isObjectRecord2(classSchema) && Object.values(classSchema).includes(memberId);
-  }) ?? null;
+function containingClass(context, memberId) {
+  if (typeof memberId !== "string") return null;
+  return context.ownersByMemberId.get(memberId) ?? null;
 }
 function bodyOwnerName(thisClass) {
   if (thisClass === null) return null;
   if (typeof thisClass.name !== "string") return null;
   return thisClass.name;
 }
-function compileNSPropertyChange(schema, memberData, locator) {
+function compileNSPropertyChange(context, memberData, locator) {
   const memberId = memberData.id;
-  const thisClass = containingClass(schema, memberId);
+  const thisClass = containingClass(context, memberId);
   const returnTypeInfo = resolveNSPropertyReturnTypeInfo2(
     memberData,
-    schema.members
+    context.membersById
   );
   const bodyIdentity = {
     recordKind: "member",
@@ -131357,7 +131862,7 @@ function compileNSPropertyChange(schema, memberData, locator) {
     const code = memberData.code;
     next.getter = compileNeoScriptBodyOrThrow(
       () => compileNSGetter2(code, {
-        ...postPushCompilerProject(schema),
+        ...context.project(),
         thisClass,
         returnTypeInfo,
         dialogueContext: null,
@@ -131374,7 +131879,7 @@ function compileNSPropertyChange(schema, memberData, locator) {
     const setterCode = memberData.setterCode;
     next.setter = compileNeoScriptBodyOrThrow(
       () => compileNSSetter2(setterCode, {
-        ...postPushCompilerProject(schema),
+        ...context.project(),
         thisClass,
         valueTypeInfo: returnTypeInfo,
         implicitMemberAccess: true,
@@ -131388,18 +131893,18 @@ function compileNSPropertyChange(schema, memberData, locator) {
   }
   return next;
 }
-function compileNSFunctionChange(schema, memberData, locator) {
+function compileNSFunctionChange(context, memberData, locator) {
   const next = { ...memberData };
   if (typeof memberData.code !== "string") {
     delete next.action;
     return next;
   }
   const code = memberData.code;
-  const contract = resolveNSFunctionContract(memberData, schema.members);
-  const thisClass = containingClass(schema, memberData.id);
+  const contract = resolveNSFunctionContract(memberData, context.membersById);
+  const thisClass = containingClass(context, memberData.id);
   next.action = compileNeoScriptBodyOrThrow(
     () => compileNSFunction2(code, {
-      ...postPushCompilerProject(schema),
+      ...context.project(),
       thisClass,
       returnTypeInfo: contract.returnTypeInfo,
       argumentTypes: contract.argumentTypes,
@@ -131422,6 +131927,7 @@ function compileNSFunctionChange(schema, memberData, locator) {
 }
 function prepareCompleteNeoScriptBodyChanges(workspace, status, schema, options = {}) {
   const completeSweep = options.completeSweep ?? false;
+  const context = createPostPushCompileContext(schema);
   const locator = options.bodySourceLocator ?? createNeoScriptBodySourceLocator(workspace, status);
   const changesById = new Map(
     status.changes.filter((change) => change.recordKind === "member").map((change) => [change.recordId, change])
@@ -131432,10 +131938,10 @@ function prepareCompleteNeoScriptBodyChanges(workspace, status, schema, options
       return member;
     }
     if (member.kind === 10 /* NSProperty */) {
-      return compileNSPropertyChange(schema, member, locator);
+      return compileNSPropertyChange(context, member, locator);
     }
     if (member.kind === 23 /* NSFunction */) {
-      return compileNSFunctionChange(schema, member, locator);
+      return compileNSFunctionChange(context, member, locator);
     }
     return member;
   });
@@ -131485,6 +131991,7 @@ function prepareCompleteNeoScriptBodyChanges(workspace, status, schema, options
     status.changes.push(cascadeChange);
     changesById.set(compiled.id, cascadeChange);
   }
+  return context;
 }
 function mergeCompiledNeoScriptBody(persisted, compiled) {
   const next = { ...persisted };
@@ -131681,7 +132188,7 @@ function resolveNSPropertyReturnTypeInfo2(member, members) {
       );
     }
     visited.add(parentId);
-    current = members.find((candidate) => candidate.id === parentId);
+    current = members.get(parentId);
   }
   throw new Error(
     `Cannot compile NeoScript property "${String(member.id)}": its returnTypeInfo could not be resolved from the base chain.`
@@ -131708,7 +132215,7 @@ function resolveNSFunctionContract(member, members) {
       );
     }
     visited.add(parentId);
-    current = members.find((candidate) => candidate.id === parentId);
+    current = members.get(parentId);
     if (current === void 0) {
       throw new Error(
         `Cannot compile NeoScript function "${String(member.id)}": missing parent member "${parentId}".`
@@ -131726,15 +132233,13 @@ function resolveNSFunctionContract(member, members) {
     deferred: dispatch === 1
   };
 }
-function compileMigrationAction(schema, migrationData, locator) {
+function compileMigrationAction(context, migrationData, locator) {
   const targetClassId = migrationData.targetClassId;
-  const thisClass = typeof targetClassId === "string" ? schema.classes.find(
-    (schemaClass2) => schemaClass2.id === targetClassId
-  ) ?? null : null;
+  const thisClass = typeof targetClassId === "string" ? context.classesById.get(targetClassId) ?? null : null;
   const code = String(migrationData.code);
   return compileNeoScriptBodyOrThrow(
     () => compileNSVoidBody2(code, {
-      ...postPushCompilerProject(schema),
+      ...context.project(),
       thisClass,
       dialogueContext: null,
       migrationContext: true
@@ -131750,7 +132255,7 @@ function compileMigrationAction(schema, migrationData, locator) {
     locator
   );
 }
-var compileNSVoidBody2, compileNSFunction2, compileNSGetter2, compileNSSetter2, ProjectTransactionInterruptedError, ProjectTransactionFailedError, PROJECT_TRANSACTION_POLL_DELAYS_MS, LocalCandidateArtifactError, SERVER_MINTED_PUSH_RECORD_KINDS;
+var compileNSVoidBody2, compileNSFunction2, compileNSGetter2, compileNSSetter2, createNeoScriptCompilationProject2, ProjectTransactionInterruptedError, ProjectTransactionFailedError, PROJECT_TRANSACTION_POLL_DELAYS_MS, LocalCandidateArtifactError, SERVER_MINTED_PUSH_RECORD_KINDS;
 var init_push = __esm({
   "src/commands/push.ts"() {
     "use strict";
@@ -131796,7 +132301,8 @@ var init_push = __esm({
       compileNSVoidBody: compileNSVoidBody2,
       compileNSFunction: compileNSFunction2,
       compileNSGetter: compileNSGetter2,
-      compileNSSetter: compileNSSetter2
+      compileNSSetter: compileNSSetter2,
+      createNeoScriptCompilationProject: createNeoScriptCompilationProject2
     } = compiler_adapter_exports);
     ProjectTransactionInterruptedError = class extends Error {
       constructor(transactionId) {
@@ -131846,7 +132352,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.49.0",
+      cliVersion: "0.50.1",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -138896,7 +139402,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.49.0");
+    console.log("0.50.1");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {