Lost Lily/Grid ToolkitDocs 1.0
Table of Contents

Pre-1.0 reset policy

Grid Toolkit 1.0.0 begins the published 1.x compatibility contract. Prototype, unpublished, preview, and other pre-1.0 builds are not supported as an in-place upgrade source.

API reset

  1. Remove the old package completely.
  2. Import 1.0.0 and resolve its dependencies.
  3. Recompile project integrations against the public 1.0.0 assemblies.
  4. Replace renamed or removed calls using the 1.0.0 handbook and API reference.
  5. Replace dependencies on unsupported internal APIs with public 1.0.0 contracts.
  6. Re-run project tests for previews, apply, revisions, events, rollback, persistence, and renderer binding.

Do not edit the shipped public API to make pre-1.0 project code compile.

Serialized-authoring reset

Pre-1.0 ScriptableObjects, prefabs, scenes, and managed-reference payloads may contain obsolete type names or field layouts.

  1. Export the game-owned source data you actually need: coordinates, IDs, footprints, placements, policy values, and extension payload data.
  2. Recreate Grid Toolkit board, structure, setup, policy, resolver, visual, Inventory, and Cell Metadata assets with 1.0.0 types.
  3. Re-enter or import game-owned data through a project-owned, reviewed migration.
  4. Validate and build every recreated asset.
  5. Review serialized diffs and keep the new .meta GUIDs stable after acceptance.

Do not copy pre-1.0 YAML fields into 1.0.0 assets or assume a missing managed reference is harmless.

Snapshot reset

Do not feed pre-1.0 snapshots to 1.0.0 restoration.

  • Start a new save-schema version.
  • Discard development snapshots, or parse them with project-owned legacy code into a neutral migration model.
  • Construct a valid 1.0.0 snapshot or board through public builders and resolvers.
  • Validate the result, restore atomically, and verify revision/event behavior.
  • Preserve unknown payloads only when their identity and byte/data contract is explicitly known; preservation does not convert an obsolete payload.

Completion criteria

The reset is complete when:

  • no pre-1.0 assemblies remain;
  • every integration compiles through public 1.0.0 contracts;
  • every recreated authored asset builds without errors;
  • old snapshots are rejected or migrated outside Grid Toolkit; and
  • project tests cover the new boundary.