@neocompose/cli 0.65.1 → 0.67.0

package/dist/neo.mjs

@@ -5959,6 +5959,10 @@ var init_neoflow_graph_parser = __esm({
 });
 
 // ../packages/neoscript-language/src/project-source-ast.ts
+function neoSourceTypeText(type) {
+  const args = type.typeArguments.length > 0 ? `<${type.typeArguments.map(neoSourceTypeText).join(", ")}>` : "";
+  return `${type.name}${args}${type.nullable ? "?" : ""}`;
+}
 function isNeoSourceAccessModifier(value) {
   return value === "public" || value === "protected" || value === "private";
 }
@@ -7892,6 +7896,9 @@ function tripleInterpolationEnd(text, start, limit) {
   }
   return null;
 }
+function rangesEqual(left, right) {
+  return positionCompare(left.start, right.start) === 0 && positionCompare(left.end, right.end) === 0;
+}
 function positionCompare(left, right) {
   return left.line === right.line ? left.character - right.character : left.line - right.line;
 }
@@ -8367,7 +8374,8 @@ var init_project_schema_contract_generated = __esm({
           "DialogueMemoryContainer",
           "DialoguePriorityDefault",
           "PolicyImmutable",
-          "PolicyDeleteBlocked"
+          "PolicyDeleteBlocked",
+          "ScriptRuntime"
         ],
         "NeoMemberRequirement": [
           "Optional",
@@ -16363,7 +16371,7 @@ var NEOSCRIPT_COMPILER_REVISION;
 var init_strict_ir = __esm({
   "../packages/neoscript-language/src/strict-ir.ts"() {
     "use strict";
-    NEOSCRIPT_COMPILER_REVISION = 16;
+    NEOSCRIPT_COMPILER_REVISION = 17;
   }
 });
 
@@ -20108,7 +20116,10 @@ var init_strict_resolver = __esm({
                 canonicalDecimal(expression.raw, expression.pos)
               );
             }
-            return literal({ kind: "primitive", name: "float" }, expression.value);
+            return literal(
+              { kind: "primitive", name: "float" },
+              Math.fround(expression.value)
+            );
           }
           case "litString":
             return literal({ kind: "primitive", name: "string" }, expression.value);
@@ -24742,7 +24753,9 @@ var init_strict_resolver = __esm({
               arithmetic: {
                 type: operator,
                 pointers: [left.pointer, right.pointer],
-                ...isPrimitive(result, "decimal") ? { decimal: true } : {}
+                ...isPrimitive(result, "decimal") ? { decimal: true } : {},
+                ...isPrimitive(result, "int") ? { numeric: "int" } : {},
+                ...isPrimitive(result, "float") ? { numeric: "float" } : {}
               }
             }
           },
@@ -26424,6 +26437,40 @@ var init_project_source_script_compiler = __esm({
   }
 });
 
+// ../packages/neoscript-language/src/project-source-lifecycle-hooks.ts
+function isScriptRuntimeInterface(declaration) {
+  const kind = declaration.annotations.find((annotation2) => annotation2.name === "system")?.arguments.find((argument2) => argument2.name === "kind")?.text.trim();
+  return kind === ".ScriptRuntime";
+}
+function lifecycleHooksByMemberName(interfaces) {
+  const hooks = /* @__PURE__ */ new Map();
+  for (const declaration of interfaces) {
+    if (!isScriptRuntimeInterface(declaration)) continue;
+    for (const member of declaration.members) {
+      if (member.kind !== "function") continue;
+      hooks.set(member.name.toLowerCase(), {
+        interfaceName: declaration.name,
+        member,
+        ...declaration.docsText === void 0 ? {} : { docsText: declaration.docsText },
+        unity: declaration.name.startsWith(UNITY_LIFECYCLE_INTERFACE_PREFIX)
+      });
+    }
+  }
+  return hooks;
+}
+function reservedLifecycleMemberMessage(memberName, interfaceName, owner) {
+  const fix = owner === "class" ? "Implement the interface with a public method" : "Extend the interface";
+  return `'${memberName}' is reserved for '${interfaceName}'. ${fix}, or rename the member.`;
+}
+var NEO_LIFECYCLE_OBJECT_CLASS_NAME, UNITY_LIFECYCLE_INTERFACE_PREFIX;
+var init_project_source_lifecycle_hooks = __esm({
+  "../packages/neoscript-language/src/project-source-lifecycle-hooks.ts"() {
+    "use strict";
+    NEO_LIFECYCLE_OBJECT_CLASS_NAME = "NeoObjectBase";
+    UNITY_LIFECYCLE_INTERFACE_PREFIX = "INeoUnity";
+  }
+});
+
 // ../packages/neoscript-language/src/project-source-type-checker.ts
 function validateProjectSourceTypes(documents) {
   const diagnostics = [];
@@ -26433,6 +26480,7 @@ function validateProjectSourceTypes(documents) {
   validateInheritanceCycles(environment, diagnostics);
   validateAllTypeApplications(documents, environment, diagnostics);
   validateMembers(environment, diagnostics);
+  validateLifecycleHooks(environment, diagnostics);
   return diagnostics;
 }
 function createEnvironment2(documents) {
@@ -26489,7 +26537,16 @@ function createEnvironment2(documents) {
       }
     }
   }
-  return { declarations, classes, interfaces, memberOwners, typeKinds };
+  return {
+    declarations,
+    classes,
+    interfaces,
+    memberOwners,
+    typeKinds,
+    lifecycleHooks: lifecycleHooksByMemberName(
+      [...interfaces.values()].map((ref) => ref.declaration)
+    )
+  };
 }
 function validatePersistedNames(documents, diagnostics) {
   for (const [uri, document] of documents) {
@@ -27500,7 +27557,7 @@ function validateEffects(ref, environment, diagnostics) {
       kind = inheritedEffectKind(inherited, member.name);
     }
     if (kind !== "Auto") continue;
-    const problem = effectIneligibility(member);
+    const problem = effectIneligibility(member) ?? (environment.lifecycleHooks.has(member.name.toLowerCase()) ? "the runtime already calls a lifecycle hook, so its first run would happen twice" : null);
     if (problem === null) continue;
     diagnose(
       diagnostics,
@@ -27550,6 +27607,110 @@ function effectIneligibility(member) {
   if (member.parameters.length > 0) return "an effect takes no parameters";
   return null;
 }
+function validateLifecycleHooks(environment, diagnostics) {
+  const hooks = environment.lifecycleHooks;
+  if (hooks.size === 0) return;
+  for (const ref of environment.interfaces.values()) {
+    if (isScriptRuntimeInterface(ref.declaration)) continue;
+    for (const member of ref.declaration.members) {
+      const hook = hooks.get(member.name.toLowerCase());
+      if (hook === void 0) continue;
+      diagnose(
+        diagnostics,
+        ref.uri,
+        member.nameRange,
+        "reserved-lifecycle-member",
+        reservedLifecycleMemberMessage(
+          member.name,
+          hook.interfaceName,
+          "interface"
+        )
+      );
+    }
+  }
+  const unityHookByInterface = /* @__PURE__ */ new Map();
+  for (const ref of environment.classes.values()) {
+    if (ref.sourceKind === "flow") continue;
+    let implemented;
+    for (const member of ref.declaration.members) {
+      const hook = hooks.get(member.name.toLowerCase());
+      if (hook === void 0) continue;
+      implemented ??= new Set(
+        implementedInterfaces(ref, environment).map(
+          (view) => view.owner.declaration.name
+        )
+      );
+      if (member.kind === "function" && effectiveSourceAccessModifier(member.modifiers, "class") === "public" && !member.modifiers.includes("static") && !member.modifiers.includes("async") && implemented.has(hook.interfaceName)) {
+        continue;
+      }
+      diagnose(
+        diagnostics,
+        ref.uri,
+        member.nameRange,
+        "reserved-lifecycle-member",
+        reservedLifecycleMemberMessage(
+          member.name,
+          hook.interfaceName,
+          "class"
+        )
+      );
+    }
+    let rendersObjects;
+    for (const base of ref.declaration.baseTypes) {
+      const target = environment.interfaces.get(base.name);
+      if (target === void 0) continue;
+      const unityHook = unityHookReachedBy(
+        target,
+        environment,
+        unityHookByInterface
+      );
+      if (unityHook === null) continue;
+      rendersObjects ??= extendsLifecycleObjectClass(ref, environment);
+      if (rendersObjects) break;
+      diagnostics.push({
+        uri: ref.uri,
+        range: base.range,
+        severity: "warning",
+        source: "neo-project",
+        code: "lifecycle-hook-without-object",
+        message: `'${unityHook}' does nothing on '${ref.declaration.name}'. Only classes that extend ${NEO_LIFECYCLE_OBJECT_CLASS_NAME} get Unity lifecycle calls.`
+      });
+    }
+  }
+}
+function unityHookReachedBy(ref, environment, memo) {
+  const name = ref.declaration.name;
+  const known = memo.get(name);
+  if (known !== void 0) return known;
+  memo.set(name, null);
+  let reached = null;
+  if (isScriptRuntimeInterface(ref.declaration) && ref.declaration.members.some(
+    (member) => environment.lifecycleHooks.get(member.name.toLowerCase())?.unity === true
+  )) {
+    reached = name;
+  }
+  for (const base of ref.declaration.baseTypes) {
+    if (reached !== null) break;
+    const target = environment.interfaces.get(base.name);
+    if (target !== void 0) {
+      reached = unityHookReachedBy(target, environment, memo);
+    }
+  }
+  memo.set(name, reached);
+  return reached;
+}
+function extendsLifecycleObjectClass(ref, environment) {
+  const visited = /* @__PURE__ */ new Set();
+  let current = ref;
+  while (current !== null && !visited.has(current.declaration.name)) {
+    if (current.declaration.name === NEO_LIFECYCLE_OBJECT_CLASS_NAME) {
+      return true;
+    }
+    visited.add(current.declaration.name);
+    current = classBase(current, identitySubstitution(current), environment)?.owner ?? null;
+  }
+  return false;
+}
 function isPlatformImplementedSystemMember(member) {
   if (!member.modifiers.includes("protected")) return false;
   return member.annotations.some((entry) => entry.name === "system");
@@ -28019,6 +28180,7 @@ var init_project_source_type_checker = __esm({
     init_strict_compile_error();
     init_project_source_accessors();
     init_project_source_identifiers();
+    init_project_source_lifecycle_hooks();
     BUILTIN_ARITY = /* @__PURE__ */ new Map([
       ["List", 1],
       ["Set", 1],
@@ -28208,12 +28370,12 @@ function classifyConstantExpression(expression) {
 function defaultTypeMismatch(type, constant, enumOptions, parameterName) {
   if (constant.kind === "null") {
     if (type.nullable) return null;
-    return `Parameter '${parameterName}' defaults to null, but its type '${formatSourceType(type)}' is not nullable.`;
+    return `Parameter '${parameterName}' defaults to null, but its type '${neoSourceTypeText(type)}' is not nullable.`;
   }
   const declaredEnumOptions = enumOptions.get(type.name);
   if (constant.kind === "enumOption") {
     if (declaredEnumOptions === void 0) {
-      return `Parameter '${parameterName}' defaults to enum option '.${constant.optionName}', but its type '${formatSourceType(type)}' is not an enum.`;
+      return `Parameter '${parameterName}' defaults to enum option '.${constant.optionName}', but its type '${neoSourceTypeText(type)}' is not an enum.`;
     }
     if (!declaredEnumOptions.has(constant.optionName)) {
       return `Parameter '${parameterName}' defaults to '.${constant.optionName}', which enum '${type.name}' does not declare.`;
@@ -28222,9 +28384,9 @@ function defaultTypeMismatch(type, constant, enumOptions, parameterName) {
   }
   if (constantKindMatchesPrimitive(type.name, constant.kind)) return null;
   if (PRIMITIVE_PARAMETER_TYPES.has(type.name) || declaredEnumOptions !== void 0) {
-    return `Parameter '${parameterName}' default is a ${describeConstant(constant)}, which does not match its declared type '${formatSourceType(type)}'.`;
+    return `Parameter '${parameterName}' default is a ${describeConstant(constant)}, which does not match its declared type '${neoSourceTypeText(type)}'.`;
   }
-  return `Parameter '${parameterName}' of type '${formatSourceType(type)}' can only default to null${type.nullable ? "" : ", and only when the type is nullable"}.`;
+  return `Parameter '${parameterName}' of type '${neoSourceTypeText(type)}' can only default to null${type.nullable ? "" : ", and only when the type is nullable"}.`;
 }
 function constantKindMatchesPrimitive(typeName, kind) {
   if (typeName === "bool") return kind === "bool";
@@ -28240,15 +28402,12 @@ function describeConstant(constant) {
   if (constant.kind === "int") return "whole-number literal";
   return "fractional number literal";
 }
-function formatSourceType(type) {
-  const argumentsText = type.typeArguments.length === 0 ? "" : `<${type.typeArguments.map(formatSourceType).join(", ")}>`;
-  return `${type.name}${argumentsText}${type.nullable ? "?" : ""}`;
-}
 var PARAMETER_DEFAULT_DIAGNOSTIC_CODES, DEFAULT_BEFORE_REQUIRED_PARAMETER, PARAMETER_DEFAULT_TYPE_MISMATCH, NON_CONSTANT_PARAMETER_DEFAULT, PARAMETER_DEFAULT_ON_DEFERRED_FUNCTION, PRIMITIVE_PARAMETER_TYPES;
 var init_project_source_parameter_defaults = __esm({
   "../packages/neoscript-language/src/project-source-parameter-defaults.ts"() {
     "use strict";
     init_language_spec();
+    init_project_source_ast();
     init_executable_parser();
     PARAMETER_DEFAULT_DIAGNOSTIC_CODES = {
       defaultBeforeRequiredParameter: "default-before-required-parameter",
@@ -29955,7 +30114,7 @@ var init_registry = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.65.1",
+      cliVersion: "0.67.0",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -30660,7 +30819,8 @@ var init_registry = __esm({
               "DialogueMemoryContainer",
               "DialoguePriorityDefault",
               "PolicyImmutable",
-              "PolicyDeleteBlocked"
+              "PolicyDeleteBlocked",
+              "ScriptRuntime"
             ],
             NeoMemberRequirement: ["Optional", "Required"],
             NeoMemberMutability: ["Mutable", "ReadOnly"],
@@ -34170,7 +34330,8 @@ var init_schema_member = __esm({
       "dialogueMemoryContainer",
       "dialoguePriorityDefault",
       "policyImmutable",
-      "policyDeleteBlocked"
+      "policyDeleteBlocked",
+      "scriptRuntime"
     ]);
     worldSystemClassKindSchema = picklist([
       "cellPattern",
@@ -35728,7 +35889,8 @@ function isSchemaSystemMetadata(value) {
     "dialogueMemoryContainer",
     "dialoguePriorityDefault",
     "policyImmutable",
-    "policyDeleteBlocked"
+    "policyDeleteBlocked",
+    "scriptRuntime"
   ]);
   const worlds = /* @__PURE__ */ new Set([
     "cellPattern",
@@ -39273,6 +39435,47 @@ var init_project_manifest = __esm({
   }
 });
 
+// ../src/models/members/float32.ts
+function isFloat32(value) {
+  return typeof value === "number" && Number.isFinite(value) && Math.fround(value) === value;
+}
+function unroundedFloatPath(data, path = "") {
+  if (typeof data === "number") {
+    if (Number.isInteger(data)) return null;
+    return isFloat32(data) ? null : path;
+  }
+  if (typeof data !== "object" || data === null) return null;
+  if (Array.isArray(data)) {
+    for (let index = 0; index < data.length; index++) {
+      const found = unroundedFloatPath(data[index], `${path}[${index}]`);
+      if (found !== null) return found;
+    }
+    return null;
+  }
+  for (const [key, value] of Object.entries(data)) {
+    const found = unroundedFloatPath(
+      value,
+      path === "" ? key : `${path}.${key}`
+    );
+    if (found !== null) return found;
+  }
+  return null;
+}
+function float32Text(value) {
+  if (Number.isInteger(value)) return String(value);
+  if (Math.fround(value) !== value) return String(value);
+  for (let precision = 1; precision <= 9; precision++) {
+    const text = String(Number(value.toPrecision(precision)));
+    if (Math.fround(Number(text)) === value) return text;
+  }
+  return String(value);
+}
+var init_float32 = __esm({
+  "../src/models/members/float32.ts"() {
+    "use strict";
+  }
+});
+
 // src/project-source/source-format.ts
 function quoteNeoString(value) {
   return JSON.stringify(value);
@@ -39293,7 +39496,7 @@ function formatNeoNumber(value) {
   if (!Number.isFinite(value)) {
     throw new Error(`Cannot emit non-finite Neo number ${String(value)}.`);
   }
-  const source = String(value);
+  const source = float32Text(value);
   const match = /^(?<sign>-?)(?<integer>\d+)(?:\.(?<fraction>\d+))?[eE](?<exponent>[+-]?\d+)$/u.exec(
     source
   );
@@ -39317,6 +39520,7 @@ function invariantCaseKey(value) {
 var init_source_format = __esm({
   "src/project-source/source-format.ts"() {
     "use strict";
+    init_float32();
     init_machine_strings();
   }
 });
@@ -40146,7 +40350,7 @@ function isEpochMillis(value) {
   return Number.isFinite(value);
 }
 function isSystemProtectionKind(value) {
-  return value === SystemProtectionKind.WorldAuthoring || value === SystemProtectionKind.DialogueMemorySchema || value === SystemProtectionKind.DialogueMemoryContainer || value === SystemProtectionKind.DialoguePriorityDefault || value === SystemProtectionKind.PolicyImmutable || value === SystemProtectionKind.PolicyDeleteBlocked;
+  return value === SystemProtectionKind.WorldAuthoring || value === SystemProtectionKind.DialogueMemorySchema || value === SystemProtectionKind.DialogueMemoryContainer || value === SystemProtectionKind.DialoguePriorityDefault || value === SystemProtectionKind.PolicyImmutable || value === SystemProtectionKind.PolicyDeleteBlocked || value === SystemProtectionKind.ScriptRuntime;
 }
 function isSystemMetadata(value) {
   const v = value;
@@ -40190,7 +40394,8 @@ var init_core_types = __esm({
       DialogueMemoryContainer: "dialogueMemoryContainer",
       DialoguePriorityDefault: "dialoguePriorityDefault",
       PolicyImmutable: "policyImmutable",
-      PolicyDeleteBlocked: "policyDeleteBlocked"
+      PolicyDeleteBlocked: "policyDeleteBlocked",
+      ScriptRuntime: "scriptRuntime"
     };
   }
 });
@@ -40543,7 +40748,7 @@ function hasValidParameterDefault(value) {
     case 2 /* Int */:
       return typeof payload === "number" && Number.isInteger(payload);
     case 4 /* Float */:
-      return typeof payload === "number" && Number.isFinite(payload);
+      return isFloat32(payload);
     case 20 /* Decimal */:
     case 3 /* String */:
     case 8 /* Enum */:
@@ -40829,6 +41034,9 @@ function isNSArithmeticOperationInfo(value) {
   const v = value;
   if (typeof v !== "object" || v === null) return false;
   if (!isNSArithmeticOperationType(v.type)) return false;
+  if (v.numeric !== void 0 && v.numeric !== "int" && v.numeric !== "float") {
+    return false;
+  }
   return isNSPointers(v.pointers);
 }
 function isNSArithmeticOperation(value) {
@@ -41399,6 +41607,7 @@ var init_neoscript_guards = __esm({
     "use strict";
     init_neoscript_compiler_revision();
     init_member_kind_enum();
+    init_float32();
     init_structural_narrow();
     init_core_types();
     init_neoscript_types();
@@ -41795,10 +42004,14 @@ function isStructuredLeafFieldValue(type, value) {
     return typeof value === "string" && value.length > 0;
   }
   if (typeof value !== "number" || !Number.isFinite(value)) return false;
-  if (type === "float") return true;
+  if (type === "float") return isFloat32(value);
   if (type === "int") return Number.isInteger(value);
   if (type === "sliceIndex") return Number.isInteger(value) && value >= 0;
-  return value >= 0 && value <= 1;
+  return isFloat32(value) && value >= 0 && value <= 1;
+}
+function storedStructuredLeafFieldNumber(type, value) {
+  const float = type === "float" || type === "unitFloat";
+  return float ? Math.fround(value) : value;
 }
 function isStructuredLeafPartialValue(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
@@ -41817,22 +42030,43 @@ function structuredLeafPartialViolation(kind, value, legalKeysLabel) {
       return `has no field "${key}"; ${legalKeysLabel} accepts ${structuredLeafFieldKeys(kind).join(", ")}`;
     }
     if (isStructuredLeafFieldValue(field.type, fieldValue)) continue;
-    return `field "${key}" ${structuredLeafFieldViolation(field.type)}`;
+    return `field "${key}" ${structuredLeafFieldViolation(field.type, fieldValue)}`;
   }
   return null;
 }
-function structuredLeafFieldViolation(type) {
+function structuredLeafRecordFieldViolation(kind, value) {
+  if (typeof value !== "object" || value === null) return null;
+  if (Array.isArray(value)) return null;
+  const entries = Object.entries(value);
+  if (entries.length !== structuredLeafFields(kind).length) return null;
+  let found = null;
+  for (const [key, fieldValue] of entries) {
+    const field = structuredLeafField(kind, key);
+    if (field === null) return null;
+    if (typeof fieldValue !== "number") return null;
+    if (found !== null) continue;
+    if (isStructuredLeafFieldValue(field.type, fieldValue)) continue;
+    found = {
+      key,
+      value: fieldValue,
+      violation: structuredLeafFieldViolation(field.type, fieldValue)
+    };
+  }
+  return found;
+}
+function structuredLeafFieldViolation(type, value) {
   if (type === "fileId") return "must be a non-empty file id";
-  if (type === "float") return "must be a finite number";
   if (type === "int") return "must be a whole number";
   if (type === "sliceIndex") return "must be a whole number 0 or greater";
-  return "must be a number between 0 and 1";
+  if (!isFloat32(value)) return "must be a 32-bit float";
+  return "must be between 0 and 1";
 }
 var STRUCTURED_LEAF_FIELDS, STRUCTURED_LEAF_PARTIAL_KEY;
 var init_structured_leaf_fields = __esm({
   "../src/models/members/structured-leaf-fields.ts"() {
     "use strict";
     init_member_kind_enum();
+    init_float32();
     STRUCTURED_LEAF_FIELDS = {
       [11 /* Sprite */]: [
         { name: "FileId", key: "fileId", type: "fileId" },
@@ -41985,9 +42219,9 @@ function isMemberString(value) {
 function isMemberFloatBase(value) {
   const v = asMemberBaseForKind(value, 4 /* Float */);
   if (v === null) return false;
-  if (v.minValue !== void 0 && v.minValue !== null && typeof v.minValue !== "number")
+  if (v.minValue !== void 0 && v.minValue !== null && !isFloat32(v.minValue))
     return false;
-  if (v.maxValue !== void 0 && v.maxValue !== null && typeof v.maxValue !== "number")
+  if (v.maxValue !== void 0 && v.maxValue !== null && !isFloat32(v.maxValue))
     return false;
   return v.decimalPoints === void 0 || v.decimalPoints === null || typeof v.decimalPoints === "number";
 }
@@ -41996,12 +42230,8 @@ function hasExactKeys(value, keys) {
   if (actual.length !== keys.length) return false;
   return keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
 }
-function isFiniteNumberValue(value) {
-  return typeof value === "number" && Number.isFinite(value);
-}
 function isVectorComponentValue(value, integer3) {
-  if (!isFiniteNumberValue(value)) return false;
-  if (!integer3) return true;
+  if (!integer3) return isFloat32(value);
   return Number.isInteger(value);
 }
 function isVector2ValueWithComponents(value, integer3) {
@@ -42035,7 +42265,7 @@ function isVector3IntValue(value) {
   return isVector3ValueWithComponents(value, true);
 }
 function isColorComponentValue(value) {
-  if (!isFiniteNumberValue(value)) return false;
+  if (!isFloat32(value)) return false;
   return value >= 0 && value <= 1;
 }
 function isColorValue(value) {
@@ -43001,6 +43231,7 @@ var init_member_kinds = __esm({
     init_structural_narrow();
     init_core_types();
     init_docs_text2();
+    init_float32();
     init_schema_identifiers();
     init_neoscript_guards();
     init_neoscript_types();
@@ -49515,6 +49746,8 @@ function structuredLeafPartialMemberViolation(member, value, position) {
   return structuredLeafPartialViolation(kind, value, MemberKind[kind]);
 }
 function storedLeafShapeIssueMessage(issue, style) {
+  if (issue.kind === "float") return "must store a 32-bit float.";
+  if (issue.kind === "field") return storedLeafFieldIssueMessage(issue);
   if (issue.kind === "sprite" || issue.kind === "audio") {
     return `must store a valid ${issue.kind === "sprite" ? "Sprite" : "Audio"} value.`;
   }
@@ -49525,12 +49758,15 @@ function storedLeafShapeIssueMessage(issue, style) {
   }
   return issue.kind === "decimal" ? `${issue.violation}.` : `must store ${issue.kind === "color" ? "color " : ""}${shape}.`;
 }
+function storedLeafFieldIssueMessage(issue) {
+  return `${MemberKind[issue.leaf]} field "${issue.key}" ${issue.violation}, not ${issue.value}.`;
+}
 function storedLeafExpectation(kind) {
-  if (kind === "vector2") return "{ x: number, y: number }";
+  if (kind === "vector2") return "{ x: float, y: float }";
   if (kind === "vector2Int") return "{ x: integer, y: integer }";
-  if (kind === "vector3") return "{ x: number, y: number, z: number }";
+  if (kind === "vector3") return "{ x: float, y: float, z: float }";
   if (kind === "vector3Int") return "{ x: integer, y: integer, z: integer }";
-  if (kind === "color") return "{ r, g, b, a } in [0, 1]";
+  if (kind === "color") return "{ r, g, b, a } 32-bit floats in [0, 1]";
   return "canonical decimal string";
 }
 function* storedValueChildReferences(args) {
@@ -49576,16 +49812,19 @@ function* storedValueChildEntries(args) {
 }
 function storedLeafShapeIssue(member, value) {
   switch (member.kind) {
+    // Null is an optional Float's absent value.
+    case 4 /* Float */:
+      return value === null || isFloat32(value) ? null : { kind: "float" };
     case 14 /* Vector2 */:
-      return isVector2Value(value) ? null : { kind: "vector2" };
+      return isVector2Value(value) ? null : leafIssue(member.kind, "vector2", value);
     case 15 /* Vector2Int */:
-      return isVector2IntValue(value) ? null : { kind: "vector2Int" };
+      return isVector2IntValue(value) ? null : leafIssue(member.kind, "vector2Int", value);
     case 16 /* Vector3 */:
-      return isVector3Value(value) ? null : { kind: "vector3" };
+      return isVector3Value(value) ? null : leafIssue(member.kind, "vector3", value);
     case 17 /* Vector3Int */:
-      return isVector3IntValue(value) ? null : { kind: "vector3Int" };
+      return isVector3IntValue(value) ? null : leafIssue(member.kind, "vector3Int", value);
     case 19 /* Color */:
-      return isColorValue(value) ? null : { kind: "color" };
+      return isColorValue(value) ? null : leafIssue(member.kind, "color", value);
     case 20 /* Decimal */: {
       const violation = getDecimalStringViolation(value);
       return violation === null ? null : { kind: "decimal", violation };
@@ -49598,12 +49837,17 @@ function storedLeafShapeIssue(member, value) {
       return null;
   }
 }
+function leafIssue(leaf, shape, value) {
+  const field = structuredLeafRecordFieldViolation(leaf, value);
+  return field === null ? { kind: shape } : { kind: "field", leaf, ...field };
+}
 var ANIMATION_OVERRIDE_GRAPH_MEMBER_IDS;
 var init_stored_value_shape = __esm({
   "../src/models/members/stored-value-shape.ts"() {
     "use strict";
     init_world_system_classes();
     init_member_kinds();
+    init_float32();
     init_structured_leaf_fields();
     ANIMATION_OVERRIDE_GRAPH_MEMBER_IDS = /* @__PURE__ */ new Set([
       WORLD_ANIMATION_FRAME_OVERRIDES_MEMBER_ID,
@@ -50688,16 +50932,24 @@ function validateProjectDocumentFileMemberValue(document, member, body, position
     return;
   }
   const shapeIssue = storedLeafShapeIssue(member, body.value);
+  if (shapeIssue?.kind === "float") {
+    throw new Error(
+      `Float value for member "${member.name}" must be a 32-bit float, not ${String(body.value)}.`
+    );
+  }
+  if (shapeIssue?.kind === "field") {
+    throw new Error(
+      `Member "${member.name}" ${storedLeafFieldIssueMessage(shapeIssue)}`
+    );
+  }
   if (shapeIssue?.kind === "vector2") {
-    throw new Error("Vector2 value must be { x: number, y: number }.");
+    throw new Error("Vector2 value must be { x: float, y: float }.");
   }
   if (shapeIssue?.kind === "vector2Int") {
     throw new Error("Vector2Int value must be { x: integer, y: integer }.");
   }
   if (shapeIssue?.kind === "vector3") {
-    throw new Error(
-      "Vector3 value must be { x: number, y: number, z: number }."
-    );
+    throw new Error("Vector3 value must be { x: float, y: float, z: float }.");
   }
   if (shapeIssue?.kind === "vector3Int") {
     throw new Error(
@@ -50706,7 +50958,7 @@ function validateProjectDocumentFileMemberValue(document, member, body, position
   }
   if (shapeIssue?.kind === "color") {
     throw new Error(
-      "Color value must be { r, g, b, a } with each component in [0, 1]."
+      "Color value must be { r, g, b, a } with each component a 32-bit float in [0, 1]."
     );
   }
   if (shapeIssue?.kind === "decimal") {
@@ -51537,10 +51789,13 @@ function lowerStructuredLeafFieldValue(kind, label, field, expression, lowering)
   if (field.type === "fileId") {
     return lowerStructuredLeafFileId(kind, label, field, expression, lowering);
   }
-  const value = lowering.number(expression);
+  const value = storedStructuredLeafFieldNumber(
+    field.type,
+    lowering.number(expression)
+  );
   if (isStructuredLeafFieldValue(field.type, value)) return value;
   throw new Error(
-    `${label} field ${JSON.stringify(field.name)} ${structuredLeafFieldRequirement(field.type)}, not ${value}.`
+    `${label} field ${JSON.stringify(field.name)} ${structuredLeafFieldViolation(field.type, value)}, not ${value}.`
   );
 }
 function lowerStructuredLeafFileId(kind, label, field, expression, lowering) {
@@ -51587,10 +51842,13 @@ function lowerStructuredLeafComponents(kind, label, expression, lowering) {
     if (argument2 === void 0) {
       throw new Error(`${label} is missing component ${field.name}.`);
     }
-    const component = lowering.number(argument2);
+    const component = storedStructuredLeafFieldNumber(
+      field.type,
+      lowering.number(argument2)
+    );
     if (!isStructuredLeafFieldValue(field.type, component)) {
       throw new Error(
-        `${label} component ${field.name} ${structuredLeafFieldRequirement(field.type)}, not ${component}.`
+        `${label} component ${field.name} ${structuredLeafFieldViolation(field.type, component)}, not ${component}.`
       );
     }
     value[field.key] = component;
@@ -51620,7 +51878,7 @@ function structuredLeafPartialAssignments(kind, label, value, emit) {
 function structuredLeafFieldSource(label, field, value, emit) {
   if (!isStructuredLeafFieldValue(field.type, value)) {
     throw new Error(
-      `${label} stores field ${JSON.stringify(field.name)} as ${JSON.stringify(value)}, which ${structuredLeafFieldRequirement(field.type)}.`
+      `${label} stores field ${JSON.stringify(field.name)} as ${JSON.stringify(value)}, which ${structuredLeafFieldViolation(field.type, value)}.`
     );
   }
   if (typeof value === "string") return emit.fileId(value);
@@ -51629,13 +51887,6 @@ function structuredLeafFieldSource(label, field, value, emit) {
     `${label} stores field ${JSON.stringify(field.name)} as ${JSON.stringify(value)}, which is neither a number nor a file id.`
   );
 }
-function structuredLeafFieldRequirement(type) {
-  if (type === "fileId") return "must be a non-empty file id";
-  if (type === "float") return "must be a finite number";
-  if (type === "int") return "must be a whole number";
-  if (type === "sliceIndex") return "must be a whole number 0 or greater";
-  return "must be a number between 0 and 1";
-}
 var STRUCTURED_LEAF_SOURCE_FORMS, STRUCTURED_LEAF_SOURCE_ENTRIES;
 var init_structured_leaf_source = __esm({
   "src/project-source/structured-leaf-source.ts"() {
@@ -52216,7 +52467,9 @@ function emitInterface(context, value) {
     const deferred = member.deferred ? "async " : "";
     return `${emitDocsText(member.docsText)}${id(member.id)}${access}${deferred}${renderReturnType(context, member.returnType)} ${member.name}(${member.arguments.map((argument2) => renderParameter(context, argument2)).join(", ")});`;
   });
-  return `${emitDocsText(value.docsText)}${id(value.id)}interface ${value.name}${bases.length ? ` : ${bases.join(", ")}` : ""} {
+  const system = value.system ? `${systemAnnotation2(value.system)}
+` : "";
+  return `${emitDocsText(value.docsText)}${id(value.id)}${system}interface ${value.name}${bases.length ? ` : ${bases.join(", ")}` : ""} {
 ${members.map((member) => indentNeoSourceNonEmptyLines(member, 2)).join("\n\n")}
 }
 `;
@@ -54348,7 +54601,7 @@ function lowerParameterDefaultValue(context, expression, type, path) {
           `Parameter ${path} defaults to a number literal, but its type is ${type.kind}.`
         );
       }
-      return expression.value;
+      return type.kind === "float" ? Math.fround(expression.value) : expression.value;
     case "litFloat":
       if (type.kind === "decimal") return expression.raw;
       if (type.kind !== "float") {
@@ -54356,7 +54609,7 @@ function lowerParameterDefaultValue(context, expression, type, path) {
           `Parameter ${path} defaults to a fractional literal, but its type is ${type.kind}.`
         );
       }
-      return expression.value;
+      return Math.fround(expression.value);
     case "unary": {
       if (expression.op !== "-") {
         throw new Error(
@@ -55495,8 +55748,8 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
       };
     }
     const inheritedFloat = inherited?.kind === "float" ? inherited : void 0;
-    const numericMin = min === null ? null : Number(min);
-    const numericMax = max === null ? null : Number(max);
+    const numericMin = min === null ? null : Math.fround(Number(min));
+    const numericMax = max === null ? null : Math.fround(Number(max));
     return {
       ...common,
       kind: "float",
@@ -56455,9 +56708,8 @@ function lowerExpressionValue(context, expression, declaredExpected, ownerClass,
     case "litString":
       return expression.value;
     case "litInt":
-      return expected.name === "decimal" ? expression.raw : expression.value;
     case "litFloat":
-      return expected.name === "decimal" ? expression.raw : expression.value;
+      return numberLiteralValue(expression, expected);
     case "unary": {
       if (expression.op !== "-") {
         throw new Error(
@@ -57314,6 +57566,11 @@ function positionalContextualEnumArgument(value) {
   const expression = parseAnnotationExpression(positional.expression);
   return expression.kind === "contextualEnum" ? expression.name : null;
 }
+function numberLiteralValue(expression, expected) {
+  if (expected.name === "decimal") return expression.raw;
+  if (expected.name === "float") return Math.fround(expression.value);
+  return expression.value;
+}
 function numberTextArgument(value, name) {
   const raw = argument(value, name);
   if (raw === null) return null;
@@ -72325,7 +72582,8 @@ function evalPointer(pointer, scope, ctx, resultUsage = "value") {
         callSiteId: pointer.callSiteId,
         invokeDelegate: (delegate, delegateArgs = []) => invokeDelegateValue(delegate, delegateArgs, ctx, pointer.callSiteId)
       });
-      if (intercepted?.handled === true) return intercepted.value;
+      if (intercepted?.handled === true)
+        return hostCallResult(member, intercepted.value, ctx);
       if (member === null) {
         if (pointer.missingMemberFallback === "valueEquality") {
           return jsEqual(innerThis, suppliedArgs[0]);
@@ -72361,7 +72619,8 @@ function evalPointer(pointer, scope, ctx, resultUsage = "value") {
             pointer.callSiteId
           )
         });
-        if (hosted?.handled === true) return hosted.value;
+        if (hosted?.handled === true)
+          return hostCallResult(member, hosted.value, ctx);
         const receiverId = trackedRowForValueReference(innerThis, ctx)?.id;
         throw new NativeFunctionDelegateUnavailableError(
           `No native delegate handled Function '${member.name}' (member id '${member.id}'${nativeReceiverDescription(member, innerThis, receiverId)}). Web preview and other non-native evaluator hosts must configure a native handler or call interceptor before evaluation.`,
@@ -72652,7 +72911,8 @@ function invokeDelegateValue(value, args, ctx, callSiteId, ownerReceiver, result
     callSiteId,
     invokeDelegate: (delegate, delegateArgs = []) => invokeDelegateValue(delegate, delegateArgs, ctx, callSiteId)
   });
-  if (intercepted?.handled === true) return intercepted.value;
+  if (intercepted?.handled === true)
+    return hostCallResult(member, intercepted.value, ctx);
   state.delegateStack.push(frame);
   try {
     if (member.kind === 13 /* Function */) {
@@ -72667,7 +72927,8 @@ function invokeDelegateValue(value, args, ctx, callSiteId, ownerReceiver, result
         callSiteId,
         invokeDelegate: (delegate, delegateArgs = []) => invokeDelegateValue(delegate, delegateArgs, ctx, callSiteId)
       });
-      if (hosted?.handled === true) return hosted.value;
+      if (hosted?.handled === true)
+        return hostCallResult(member, hosted.value, ctx);
       const receiverId = trackedRowForValueReference(receiver, ctx)?.id;
       throw new NativeFunctionDelegateUnavailableError(
         `No native delegate handled Function '${member.name}' (member id '${member.id}'${nativeReceiverDescription(member, receiver, receiverId)}). Web preview and other non-native evaluator hosts must configure a native handler or call interceptor before evaluation.`,
@@ -73536,13 +73797,14 @@ function runtimeCollectionEntryMatchesType(value, typeInfo, ctx, seenCollections
   return resolved !== value && runtimeValueMatchesType(resolved, typeInfo, ctx, seenCollections);
 }
 function evalVectorConstructor(vectorType, componentPointers, scope, ctx) {
-  const values = componentPointers.map(
-    (pointer) => finiteNumberArg(
+  const integer3 = vectorType === 15 /* Vector2Int */ || vectorType === 17 /* Vector3Int */;
+  const values = componentPointers.map((pointer) => {
+    const value = finiteNumberArg(
       evalPointer(pointer, scope, ctx),
       `${MemberKind[vectorType]} component`
-    )
-  );
-  const integer3 = vectorType === 15 /* Vector2Int */ || vectorType === 17 /* Vector3Int */;
+    );
+    return integer3 ? value : Math.fround(value);
+  });
   if (integer3 && values.some((value) => !Number.isInteger(value))) {
     throw new NSGetterRuntimeError(
       `${MemberKind[vectorType]} components must be integers`
@@ -74433,11 +74695,17 @@ function evalOperation(operation, scope, ctx) {
   if (operation.type === "arithmetic" /* arithmetic */) {
     const op = operation.arithmetic;
     const operands = op.pointers.map((p) => evalPointer(p, scope, ctx));
-    return applyArithmetic(op.type, operands, op.decimal === true, ctx);
+    return applyArithmetic(
+      op.type,
+      operands,
+      op.decimal === true,
+      ctx,
+      op.numeric
+    );
   }
   return evalBooleanExpression(operation.expression, scope, ctx);
 }
-function applyArithmetic(op, operands, decimal2, ctx) {
+function applyArithmetic(op, operands, decimal2, ctx, numeric) {
   if (operands.length === 0) {
     throw new NSGetterRuntimeError("Arithmetic operation with no operands");
   }
@@ -74470,31 +74738,43 @@ function applyArithmetic(op, operands, decimal2, ctx) {
       `Arithmetic operand is not numeric: ${typeof o}`
     );
   });
+  const round = numeric === "float" ? Math.fround : (value) => value;
   switch (op) {
     case "+" /* addition */:
-      return numbers.reduce((a, b) => a + b, 0);
+      return numbers.reduce((a, b) => round(a + b), 0);
     case "-" /* subtraction */:
-      return numbers.reduce((a, b, i2) => i2 === 0 ? b : a - b);
+      return numbers.reduce((a, b, i2) => i2 === 0 ? b : round(a - b));
     case "*" /* multiplication */:
-      return numbers.reduce((a, b) => a * b, 1);
+      return numbers.reduce((a, b) => round(a * b), 1);
     case "/" /* division */:
       return numbers.reduce((a, b, i2) => {
         if (i2 === 0) return b;
         if (b === 0) throw new NSGetterRuntimeError("Division by zero");
-        return a / b;
+        return numeric === "int" ? Math.trunc(a / b) : round(a / b);
       });
     case "%" /* remainder */:
       return numbers.reduce((a, b, i2) => {
         if (i2 === 0) return b;
         if (b === 0) throw new NSGetterRuntimeError("Modulo by zero");
-        return a % b;
+        return round(a % b);
       });
   }
 }
+function hostCallResult(member, value, ctx) {
+  if (typeof value !== "number" || member === null) return value;
+  if (member.kind !== 13 /* Function */ && member.kind !== 23 /* NSFunction */) {
+    return value;
+  }
+  const signature = resolveCallableSignature(member.id, member.kind, ctx);
+  return signature?.returnTypeInfo.type === 4 /* Float */ ? Math.fround(value) : value;
+}
 function coerceAssignmentValue(value, targetTypeInfo, context) {
   if (targetTypeInfo.type === 8 /* Enum */ && typeof value === "string") {
     return [value];
   }
+  if (targetTypeInfo.type === 4 /* Float */ && typeof value === "number") {
+    return Math.fround(value);
+  }
   return targetTypeInfo.type === 20 /* Decimal */ && typeof value === "number" ? coerceDecimalOperand(value, context) : value;
 }
 function coerceDecimalOperand(value, context) {
@@ -74644,7 +74924,7 @@ function evalMathOp(info, scope, ctx) {
       if (value < 0) return -1;
       return 0;
     case "sqrt":
-      return Math.sqrt(value);
+      return Math.fround(Math.sqrt(value));
   }
 }
 function evalDecimalMathOp(info, fn, scope, ctx) {
@@ -75285,8 +75565,10 @@ function evalFunction(fn, scope, ctx) {
             );
           }
           case "toFloat":
-            return floatFromDecimalString(
-              coerceDecimalOperand(receiverRaw, "ToFloat")
+            return Math.fround(
+              floatFromDecimalString(
+                coerceDecimalOperand(receiverRaw, "ToFloat")
+              )
             );
           case "toDecimal": {
             if (typeof receiverRaw !== "number") {
@@ -75794,6 +76076,9 @@ function evaluateConstructorFields(descriptor, scope, ctx) {
         `constructor field '${validated.schemaKey}'`
       );
     }
+    if (typeof value === "number" && validated.typeInfo.type === 4 /* Float */) {
+      value = Math.fround(value);
+    }
     if (value === null || value === void 0) {
       if (validated.requiredWithoutDefault) {
         throw new NSGetterRuntimeError(
@@ -76414,8 +76699,9 @@ function evaluateDeclaredConstructorArguments(info, record6, scope, ctx) {
       );
     }
     const value = byName.get(parameter4.name);
-    if (parameter4.type !== 20 /* Decimal */) return value;
     if (typeof value !== "number") return value;
+    if (parameter4.type === 4 /* Float */) return Math.fround(value);
+    if (parameter4.type !== 20 /* Decimal */) return value;
     return coerceDecimalOperand(
       value,
       `constructor argument '${parameter4.name}'`
@@ -89117,6 +89403,13 @@ function validateProjectRecordByKind(recordKind, data, options = {}) {
   if (recordKind === ProjectRecordKind.Member) {
     const memberGuard = options.members === "authored-or-compiled" ? isAnyMemberAuthoredOrCompiled : isAnyMember;
     if (memberGuard(data)) return;
+    const unrounded = unroundedFloatPath(data);
+    if (unrounded !== null) {
+      const id2 = typeof data === "object" && data !== null && "id" in data ? String(data.id) : "";
+      throw new Error(
+        `Member "${id2}" field "${unrounded}" must be a 32-bit float.`
+      );
+    }
   }
   if (recordKind === ProjectRecordKind.Value) {
     if (isMemberValue(data)) {
@@ -89212,6 +89505,7 @@ var init_project_record_validation = __esm({
     init_localization_types();
     init_unity_import_settings();
     init_project_file_authoring_identifiers();
+    init_float32();
   }
 });
 
@@ -97343,15 +97637,13 @@ function inspectStoredValueNodeInternal(options) {
     return terminal();
   }
   if (member.kind === 4 /* Float */) {
-    if (typeof row.value !== "number" || !Number.isFinite(row.value)) {
-      fail(`${path} must store a finite number.`);
-    }
+    if (!isFloat32(row.value)) fail(`${path} must store a 32-bit float.`);
     assertNumberRange(member, row.value, path);
     return terminal();
   }
-  const leafIssue = storedLeafShapeIssue(member, row.value);
-  if (leafIssue !== null) {
-    fail(`${path} ${storedLeafShapeIssueMessage(leafIssue, "graph")}`);
+  const leafIssue2 = storedLeafShapeIssue(member, row.value);
+  if (leafIssue2 !== null) {
+    fail(`${path} ${storedLeafShapeIssueMessage(leafIssue2, "graph")}`);
   }
   if (isMemberStringBase(member)) {
     if (typeof row.value !== "string") fail(`${path} must store a string.`);
@@ -97713,6 +98005,7 @@ var init_stored_value_graph_semantics = __esm({
     init_inheritance();
     init_generics();
     init_classes();
+    init_float32();
     StoredValueSemanticError = class extends Error {
       name = "StoredValueSemanticError";
     };
@@ -104757,9 +105050,7 @@ function hasValidOpaqueParameterDefault(value) {
   if (value.type === 2) {
     return typeof payload === "number" && Number.isInteger(payload);
   }
-  if (value.type === 4) {
-    return typeof payload === "number" && Number.isFinite(payload);
-  }
+  if (value.type === 4) return isFloat32(payload);
   if (value.type === 3 || value.type === 8 || value.type === 20) {
     return typeof payload === "string";
   }
@@ -106689,6 +106980,7 @@ var init_projectInterfaceValidation = __esm({
     init_classes();
     init_interface_types();
     init_member_kinds();
+    init_float32();
     init_stored_value_shape();
     init_member_storage();
     NEO_OBJECT_WORLD_KIND = "object";
@@ -108107,7 +108399,7 @@ function csharpValueType(ctx, member, saved = false, env, genericBindingSaved =
     return isRequiredMember2(member) ? "bool" : "bool?";
   if (isMemberIntBase(member)) return isRequiredMember2(member) ? "int" : "int?";
   if (isMemberFloatBase(member))
-    return isRequiredMember2(member) ? "double" : "double?";
+    return isRequiredMember2(member) ? "float" : "float?";
   if (isMemberDecimalBase(member)) {
     return isRequiredMember2(member) ? "decimal" : "decimal?";
   }
@@ -108322,7 +108614,7 @@ function csharpTypeInfoValueType(ctx, typeInfo, saved, genericEnv, genericBindin
     case 2 /* Int */:
       return optional2 ? "int?" : "int";
     case 4 /* Float */:
-      return optional2 ? "double?" : "double";
+      return optional2 ? "float?" : "float";
     case 20 /* Decimal */:
       return optional2 ? "decimal?" : "decimal";
     case 3 /* String */:
@@ -109581,6 +109873,14 @@ var init_system_protection = __esm({
         disallow: [SystemDisallowedOperation.DeleteRecord],
         reasonKey: "systemProtection.reasons.policyDeleteBlocked",
         serverReason: "System default policy may be edited but must keep one default row."
+      },
+      [SystemProtectionKind.ScriptRuntime]: {
+        disallow: [
+          SystemDisallowedOperation.EditRecord,
+          SystemDisallowedOperation.DeleteRecord
+        ],
+        reasonKey: "systemProtection.reasons.scriptRuntime",
+        serverReason: "Lifecycle interface the Neo Compose script runtime calls."
       }
     };
   }
@@ -124580,8 +124880,9 @@ function lowerValueBody(context, member, expression, base, source, environment,
     case "bool":
       return { ...next, value: requiredBoolean(expression) };
     case "int":
-    case "float":
       return { ...next, value: requiredNumber2(expression) };
+    case "float":
+      return { ...next, value: Math.fround(requiredNumber2(expression)) };
     case "decimal":
       return { ...next, value: requiredDecimal(expression) };
     case "string":
@@ -142417,6 +142718,260 @@ var init_analyzer = __esm({
   }
 });
 
+// ../packages/neoscript-language/src/project-source-lifecycle-editor.ts
+function projectLifecycleHooks(analysis) {
+  let hooks = PROJECT_LIFECYCLE_HOOKS.get(analysis);
+  if (!hooks) {
+    const interfaces = [];
+    for (const document of analysis.documents.values()) {
+      for (const declaration of document.declarations) {
+        if (declaration.kind === "interface") interfaces.push(declaration);
+      }
+    }
+    hooks = lifecycleHooksByMemberName(interfaces);
+    PROJECT_LIFECYCLE_HOOKS.set(analysis, hooks);
+  }
+  return hooks;
+}
+function projectLifecycleQuickFixes(analysis, document, diagnostic, findType) {
+  if (diagnostic.code !== "reserved-lifecycle-member") return [];
+  const source = analysis.documents.get(document.uri);
+  if (!source) return [];
+  for (const declaration of source.declarations) {
+    if (declaration.kind !== "class") continue;
+    const member = declaration.members.find(
+      (candidate) => rangesEqual(candidate.nameRange, diagnostic.range)
+    );
+    if (member?.kind !== "function") continue;
+    const hook = projectLifecycleHooks(analysis).get(member.name.toLowerCase());
+    if (hook === void 0) return [];
+    const text = new SourceText(document.text);
+    const tokens = source.syntax.tokens;
+    const edits = [];
+    if (!classLifecycleContext(declaration, findType).implemented.has(
+      hook.interfaceName
+    )) {
+      edits.push(baseListEdit(text, tokens, declaration, hook.interfaceName));
+    }
+    if (effectiveSourceAccessModifier(member.modifiers, "class") !== "public") {
+      edits.push(publicAccessEdit(text, tokens, member));
+    }
+    if (edits.length === 0) return [];
+    return [
+      {
+        title: `Implement '${hook.interfaceName}'`,
+        kind: "quickfix",
+        diagnostics: [diagnostic],
+        edit: { changes: { [document.uri]: edits } },
+        preferred: true
+      }
+    ];
+  }
+  return [];
+}
+function lifecycleMemberCompletions(analysis, document, position, findType) {
+  const hooks = projectLifecycleHooks(analysis);
+  if (hooks.size === 0) return [];
+  const source = analysis.documents.get(document.uri);
+  const declaration = source?.declarations.find(
+    (candidate) => candidate.kind === "class" && positionCompare(candidate.range.start, position) < 0 && positionCompare(position, candidate.range.end) < 0
+  );
+  if (!source || source.kind === "flow" || !declaration) return [];
+  const text = new SourceText(document.text);
+  const offset = text.offsetAt(position);
+  const site = memberDeclarationSite(
+    source.syntax.tokens,
+    declaration,
+    text,
+    offset
+  );
+  if (site === null) return [];
+  const own = new Set(
+    declaration.members.map((member) => member.name.toLowerCase())
+  );
+  const context = classLifecycleContext(declaration, findType);
+  const range2 = text.range(site.start, site.end);
+  const typed = document.text.slice(site.start, site.modifiersEnd).trim();
+  const items = [];
+  for (const [key, hook] of hooks) {
+    if (own.has(key)) continue;
+    if (hook.unity && !context.rendersObjects) continue;
+    const inherited = context.inherited.get(key);
+    if (inherited !== void 0 && !isOverridable(inherited)) continue;
+    const name = hook.member.name;
+    const snippet = `public ${inherited === void 0 ? "" : "override "}${hookSignature(hook.member)} {
+  $0
+}`;
+    items.push({
+      label: name,
+      kind: "method",
+      detail: hook.interfaceName,
+      ...hook.docsText === void 0 ? {} : { documentation: hook.docsText.split("\n")[0] },
+      insertText: snippet,
+      insertTextFormat: "snippet",
+      filterText: typed.length === 0 ? name : `${typed} ${name}`,
+      textEdit: { range: range2, newText: snippet },
+      ...context.implemented.has(hook.interfaceName) ? {} : {
+        additionalTextEdits: [
+          baseListEdit(
+            text,
+            source.syntax.tokens,
+            declaration,
+            hook.interfaceName
+          )
+        ]
+      }
+    });
+  }
+  return items;
+}
+function lifecycleHoverMarkdown(analysis, memberName) {
+  const hook = projectLifecycleHooks(analysis).get(memberName.toLowerCase());
+  if (hook === void 0) return "";
+  const docs = hook.docsText === void 0 ? "" : ` ${hook.docsText}`;
+  return `
+
+Lifecycle hook from \`${hook.interfaceName}\`.${docs}`;
+}
+function classLifecycleContext(declaration, findType) {
+  const implemented = /* @__PURE__ */ new Set();
+  const inherited = /* @__PURE__ */ new Map();
+  const pendingInterfaces = [];
+  const visitedClasses = /* @__PURE__ */ new Set();
+  let rendersObjects = false;
+  let current = declaration;
+  while (current !== void 0 && !visitedClasses.has(current.name)) {
+    visitedClasses.add(current.name);
+    if (current.name === NEO_LIFECYCLE_OBJECT_CLASS_NAME) rendersObjects = true;
+    if (current !== declaration) {
+      for (const member of current.members) {
+        const key = member.name.toLowerCase();
+        if (!inherited.has(key)) inherited.set(key, member);
+      }
+    }
+    let next;
+    for (const base of current.baseTypes) {
+      const target = findType(base.name);
+      if (target?.kind === "class") next ??= target;
+      else if (target?.kind === "interface") pendingInterfaces.push(target);
+    }
+    current = next;
+  }
+  while (pendingInterfaces.length > 0) {
+    const target = pendingInterfaces.pop();
+    if (implemented.has(target.name)) continue;
+    implemented.add(target.name);
+    for (const base of target.baseTypes) {
+      const parent = findType(base.name);
+      if (parent?.kind === "interface") pendingInterfaces.push(parent);
+    }
+  }
+  return { implemented, rendersObjects, inherited };
+}
+function isOverridable(member) {
+  if (member.modifiers.includes("sealed")) return false;
+  return member.modifiers.includes("virtual") || member.modifiers.includes("abstract") || member.modifiers.includes("override");
+}
+function hookSignature(member) {
+  const parameters = member.parameters.map(
+    (parameter4) => `${neoSourceTypeText(parameter4.type)} ${parameter4.name}`
+  ).join(", ");
+  return `${neoSourceTypeText(member.type)} ${member.name}(${parameters})`;
+}
+function baseListEdit(text, tokens, declaration, interfaceName) {
+  const last = declaration.baseTypes[declaration.baseTypes.length - 1];
+  if (last !== void 0) {
+    const end = declaration.baseTypes.length === 1 && declaration.baseClause ? declaration.baseClause.range.end : last.range.end;
+    const at4 = text.offsetAt(end);
+    return { range: text.range(at4, at4), newText: `, ${interfaceName}` };
+  }
+  const at3 = headerEnd(tokens, text.offsetAt(declaration.nameRange.end));
+  return { range: text.range(at3, at3), newText: ` : ${interfaceName}` };
+}
+function headerEnd(tokens, nameEnd) {
+  let end = nameEnd;
+  let depth = 0;
+  for (const token of tokens) {
+    if (token.start < nameEnd || token.kind === "comment") continue;
+    if (token.text === "(") depth += 1;
+    else if (token.text === ")") depth -= 1;
+    else if (depth === 0 && token.text === "{") break;
+    end = token.end;
+  }
+  return end;
+}
+function publicAccessEdit(text, tokens, member) {
+  const start = text.offsetAt(member.range.start);
+  const typeStart = text.offsetAt(member.type.range.start);
+  let firstModifier;
+  let depth = 0;
+  for (const token of tokens) {
+    if (token.start < start || token.kind === "comment") continue;
+    if (token.start >= typeStart) break;
+    if (token.text === "(") depth += 1;
+    else if (token.text === ")") depth -= 1;
+    if (depth !== 0 || token.kind !== "keyword") continue;
+    if (isNeoSourceAccessModifier(token.text)) {
+      return { range: token.range, newText: "public" };
+    }
+    firstModifier ??= token;
+  }
+  const at3 = firstModifier?.start ?? typeStart;
+  return { range: text.range(at3, at3), newText: "public " };
+}
+function memberDeclarationSite(tokens, declaration, text, offset) {
+  const headerEndOffset = text.offsetAt(
+    declaration.baseClause?.range.end ?? declaration.nameRange.end
+  );
+  const classStart = text.offsetAt(declaration.range.start);
+  const before = [];
+  let depth = 0;
+  for (const token of tokens) {
+    if (token.start < classStart || token.kind === "comment") continue;
+    if (token.kind === "eof" || token.start >= offset) break;
+    before.push(token);
+    if (token.start < headerEndOffset || token.interpolationHole) continue;
+    if (token.text === "{") depth += 1;
+    else if (token.text === "}") depth -= 1;
+  }
+  if (depth !== 1) return null;
+  let index = before.length - 1;
+  let end = offset;
+  let word = before[index];
+  if (word !== void 0 && (word.kind === "identifier" || word.kind === "type") && word.end === offset) {
+    index -= 1;
+  } else {
+    word = void 0;
+  }
+  let start = word?.start ?? offset;
+  const modifiersEnd = start;
+  while (MEMBER_SITE_MODIFIERS.has(before[index]?.text ?? "")) {
+    start = before[index].start;
+    index -= 1;
+  }
+  const boundary = before[index]?.text;
+  if (boundary !== "{" && boundary !== "}" && boundary !== ";") return null;
+  if (word !== void 0) end = word.end;
+  return { start, modifiersEnd, end };
+}
+var PROJECT_LIFECYCLE_HOOKS, MEMBER_SITE_MODIFIERS;
+var init_project_source_lifecycle_editor = __esm({
+  "../packages/neoscript-language/src/project-source-lifecycle-editor.ts"() {
+    "use strict";
+    init_project_source_ast();
+    init_project_source_lifecycle_hooks();
+    init_project_source_tokens();
+    init_source_text();
+    PROJECT_LIFECYCLE_HOOKS = /* @__PURE__ */ new WeakMap();
+    MEMBER_SITE_MODIFIERS = /* @__PURE__ */ new Set([
+      "public",
+      "protected",
+      "private",
+      "override"
+    ]);
+  }
+});
+
 // ../packages/neoscript-language/src/quick-fixes.ts
 function quickFixFor(document, diagnostic) {
   if (diagnostic.code === "missing-semicolon") {
@@ -142895,6 +143450,16 @@ function projectFallbackCompletions(analysis, document, position) {
     document,
     position
   );
+  if (!expression && !classBasePosition) {
+    for (const item of lifecycleMemberCompletions(
+      analysis,
+      document,
+      position,
+      (name) => findTypeDeclaration(analysis, name)
+    )) {
+      items.set(`${item.detail}.${item.label}`, item);
+    }
+  }
   const keywords = expression ? afterNew ? [] : ["new"] : typePosition ? [] : [
     "class",
     "interface",
@@ -143338,7 +143903,7 @@ function declaredConstructorNamedArguments(analysis, typeName, used) {
 function parameterArgumentField(parameter4) {
   return {
     name: parameter4.name,
-    type: sourceTypeText(parameter4.type),
+    type: neoSourceTypeText(parameter4.type),
     ...parameter4.defaultValue === void 0 ? {} : { defaultText: parameter4.defaultValue.text }
   };
 }
@@ -143358,7 +143923,7 @@ function projectInitializerMemberCompletions(analysis, document, position) {
   const items = unsettled.map((member) => ({
     label: member.name,
     kind: "property",
-    detail: `${sourceTypeText(member.member.type)} \u2014 required`,
+    detail: `${neoSourceTypeText(member.member.type)} \u2014 required`,
     insertText: `${member.name} = `,
     // Required members sort ahead of defaulted ones: they are the only entries
     // whose absence is a diagnostic.
@@ -143369,7 +143934,7 @@ function projectInitializerMemberCompletions(analysis, document, position) {
     items.push({
       label: member.name,
       kind: "property",
-      detail: sourceTypeText(member.type),
+      detail: neoSourceTypeText(member.type),
       insertText: `${member.name} = `,
       sortText: `1${member.name}`
     });
@@ -143407,10 +143972,6 @@ function functionParameterLabel(parameter4) {
   const suffix = parameter4.defaultValue === void 0 ? "" : ` = ${parameter4.defaultValue.text}`;
   return `${parameter4.type.name} ${parameter4.name}${suffix}`;
 }
-function sourceTypeText(type) {
-  const args = type.typeArguments.length > 0 ? `<${type.typeArguments.map(sourceTypeText).join(", ")}>` : "";
-  return `${type.name}${args}${type.nullable ? "?" : ""}`;
-}
 function projectConstructionIndex(analysis) {
   const cached = CONSTRUCTION_INDEX_CACHE.get(analysis);
   if (cached) return cached;
@@ -143688,9 +144249,10 @@ ${resolved.symbol.documentation}` : "";
 ID: \`${resolved.symbol.id}\`` : "\n\nPending ID";
   const detail = resolved.symbol.detail ? `: \`${resolved.symbol.detail}\`` : "";
   const contract = resolved.symbol.kind === "class" ? projectConstructionContractMarkdown(analysis, resolved.symbol.name) : "";
+  const lifecycle = resolved.symbol.kind === "member" && resolved.symbol.callable === true && resolved.symbol.static !== true && analysis.documents.get(resolved.symbol.location.uri)?.kind !== "flow" ? lifecycleHoverMarkdown(analysis, resolved.symbol.name) : "";
   return {
     range: resolved.token.range,
-    markdown: `**${resolved.symbol.kind}** \`${resolved.symbol.name}\`${detail}${owner}${documentation}${contract}${id2}`
+    markdown: `**${resolved.symbol.kind}** \`${resolved.symbol.name}\`${detail}${owner}${documentation}${lifecycle}${contract}${id2}`
   };
 }
 function projectBuiltinSymbolAt(document, position) {
@@ -143731,7 +144293,7 @@ Construct with \`new(${parameters})\` \u2014 this class declares a required cons
   const lines = [];
   if (required2.length > 0) {
     const members = required2.map(
-      (member) => `\`${sourceTypeText(member.member.type)} ${member.name}\``
+      (member) => `\`${neoSourceTypeText(member.member.type)} ${member.name}\``
     ).join(", ");
     lines.push(`Every construction path must settle ${members}.`);
   }
@@ -144895,7 +145457,7 @@ function declarationConstructorParameters(declaration) {
 }
 function sourceParameterProjection(parameter4) {
   return {
-    type: sourceTypeText(parameter4.type),
+    type: neoSourceTypeText(parameter4.type),
     name: parameter4.name,
     ...parameter4.defaultValue === void 0 ? {} : { defaultText: parameter4.defaultValue.text }
   };
@@ -145006,6 +145568,8 @@ var init_project_source_language_features = __esm({
     init_language_spec();
     init_project_source_semantics();
     init_project_source_variants();
+    init_project_source_lifecycle_editor();
+    init_project_source_ast();
     init_project();
     init_project_source_semantics();
     init_project_source_settlement();
@@ -145127,7 +145691,7 @@ function localValueRefactorings(analysis, document, range2) {
                 start: { line: 0, character: 0 },
                 end: { line: 0, character: 0 }
               },
-              newText: `${typeText2(type)} ${name} = ${selected};
+              newText: `${neoSourceTypeText(type)} ${name} = ${selected};
 `
             }
           ]
@@ -145136,9 +145700,6 @@ function localValueRefactorings(analysis, document, range2) {
     }
   ];
 }
-function typeText2(type) {
-  return type.name + (type.typeArguments.length === 0 ? "" : `<${type.typeArguments.map(typeText2).join(", ")}>`) + (type.nullable ? "?" : "");
-}
 function withoutValueIdentities(text) {
   const tokens = lex(text).roots.filter((token) => token.kind !== "comment");
   const removals = [];
@@ -145215,6 +145776,7 @@ var init_project_local_value_refactorings = __esm({
     init_project_local_values();
     init_project_source_language_features();
     init_source_text();
+    init_project_source_ast();
   }
 });
 
@@ -146143,6 +146705,7 @@ var init_service = __esm({
     init_project_source_identifiers();
     init_project_source_analysis();
     init_project_source_construction_quick_fixes();
+    init_project_source_lifecycle_editor();
     init_project_source_reference_family();
     init_project_source_language_features();
     init_project_source_tokens();
@@ -146460,6 +147023,14 @@ var init_service = __esm({
             actions.push(
               ...projectConstructionQuickFixes(project, state.document, diagnostic)
             );
+            actions.push(
+              ...projectLifecycleQuickFixes(
+                project,
+                state.document,
+                diagnostic,
+                (name) => findTypeDeclaration(project, name)
+              )
+            );
           }
           actions.push(...spellingQuickFixes(state.document, diagnostic));
           const edit = quickFixFor(state.document, diagnostic);
@@ -156206,7 +156777,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.65.1");
+    console.log("0.67.0");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {