@neocompose/cli 0.49.0 → 0.50.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.50.0] - 2026-09-11
+
+- Expose tile placement assets with `@tile(VoidTile)` or `@tile(asset: VoidTile)`. Pull emits the tile class beside each placement; authored bindings resolve to the existing asset metadata.
+- Add tile asset validation, completion, and class navigation to the shared language service.
+
 ## [0.49.0] - 2026-09-11
 
 - Require every constructed object's non-nullable members to be supplied by a member default, constructor, or initializer. Missing values are now compile errors.

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);
@@ -17880,6 +17888,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 +22968,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 +23542,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 +24109,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 +27838,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 +27985,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 +29448,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 +29688,8 @@ function annotationSignatureParameters(name) {
   switch (name) {
     case "id":
       return ["string id"];
+    case "tile":
+      return ["NeoTile class asset"];
     case "settings":
       return ["named settings"];
     case "storage":
@@ -34012,6 +34155,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();
@@ -52159,6 +52303,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,
@@ -53450,7 +53606,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 +53661,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 +53713,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 +53732,7 @@ function buildDefaultClassMaterializationPlan(document, classId, instanceEnv) {
       {
         schemaKey: entry.schemaKey,
         member,
+        defaultSettlesConstruction: settlesConstruction(member, instanceEnv),
         directScalarBody: directScalarDefaultBody(document, member)
       }
     ];
@@ -53772,6 +53941,7 @@ function buildDefaultMemberValue(args) {
     for (const {
       schemaKey,
       member: resolvedChildMember,
+      defaultSettlesConstruction: defaultSettlesConstruction2,
       directScalarBody
     } of member.payload === 1 /* Partial */ ? [] : materializationPlan) {
       if (storageKeyReferencesParentClass(
@@ -53787,6 +53957,7 @@ function buildDefaultMemberValue(args) {
         args.constructorRoot,
         schemaKey,
         resolvedChildMember,
+        defaultSettlesConstruction2,
         documentHasInitValueContent(
           args.document,
           resolvedChildMember.defaultValue
@@ -53794,7 +53965,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 +53975,7 @@ function buildDefaultMemberValue(args) {
       if (!shouldMaterializeChildDefaultForRoot(
         args.constructorRoot,
         resolvedChildMember,
+        defaultSettlesConstruction2,
         documentHasInitValueContent(
           args.document,
           resolvedChildMember.defaultValue
@@ -54309,18 +54481,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) {
@@ -113956,7 +114128,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 +114148,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 +114167,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 +114212,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 +114943,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 +115546,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 +115589,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 +115663,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 +116032,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 +116042,7 @@ function lowerStaticSeed(context, member, sourceExpression, source, valueId) {
   const root = lowerSeedRow(
     context,
     member,
-    expression,
+    sourceExpression,
     source,
     valueId,
     source.label,
@@ -115880,7 +116096,8 @@ function lowerSeedRow(context, member, sourceExpression, source, valueId, path,
       localizedTexts,
       containerId,
       inheritedEnvironment,
-      authoredSlice
+      authoredSlice,
+      sourceExpression
     );
   }
   if (!isStoredCallableLiteral(resolvedMember.kind, expression) && memberInitializerRequiresEvaluation(
@@ -115889,6 +116106,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 +116426,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 +116514,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 +116642,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 +116846,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 +116876,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 +119135,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 +119408,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");
@@ -131846,7 +132140,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.49.0",
+      cliVersion: "0.50.0",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -138896,7 +139190,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.0");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.49.0 -->
+<!-- reviewed-through-cli: 0.50.0 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/animation-and-world-authoring.md

@@ -24,6 +24,29 @@ For world layer links, derive a concrete project class from
 `targetLayer` relation. Do not add value-level target metadata or ask painting
 operations to create/repair relation targets.
 
+## Tile placements
+
+Use `@tile(VoidTile)` on a `NeoTileInstance` construction to select its tile
+class. The named spelling `@tile(asset: VoidTile)` is equivalent; the asset is
+required and only the argument label is optional.
+
+```neo
+@tile(VoidTile)
+new NeoTileInstance() {
+  Cell = new(9, -4)
+}
+```
+
+Pull emits the positional spelling. The annotation writes the placement's
+`assetClassId` metadata and does not construct a tile value or add a generic
+argument. The asset must be a concrete, non-generic descendant of `NeoTile`.
+Use the annotation on persisted literal constructions; executable NeoScript
+and evaluated placement constructors reject it.
+The grid's imports and the tile's compatible-layer relations still constrain
+where the placement can be used. Existing placement overrides remain attached
+when the selected asset is unchanged; recreate a placement to change its asset
+when it has overrides or a variant.
+
 ## Object variants
 
 A variant is a named configuration of one `NeoObject`-derived class: how to

package/skills/neocompose-cli/references/cli-development.md

@@ -88,7 +88,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.49.0 -->
+<!-- reviewed-through-cli: 0.50.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale