ludic/packages/ludic.save/format.ludic
Orkuncakilkaya 338202c41b play 2's frame keeps and a dropped file: a var() join made at once, the hint rail emptied in place, save_read gives its text back
- ludic.ui cv_join (units_pieces.ludic:93): a var() value's pieces were joined by +, a text left
  behind per piece on every memo miss; it is written at its length at once (units_join.ludic), and
  the miss is its own declared function (cs_vars_miss), bounded by the memo.
- ludic.hints hn_slots (rail.ludic:41): hints_reset made a new rail every time; the rail is
  emptied in place, made again only for another count (rail_slots.ludic).
- value_spare_put (value.ludic:138): a list's spares grow only past the most it has ever cut off;
  declared as such.
- ludic.save: save_read reads, parses and frees the file's text - the tree's strings are the
  parser's own - and says whether the text was whole (SaveRead.intact) for the words of a refusal.
  Maroon Lake's trip and home reads kept the whole file on every load and every menu card read.

Tests: ludic.save (10), ludic.hints (8); the 36 ui examples; value_list_regrow, json_saves and
alloc_fence_declared unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 13:33:54 +03:00

54 lines
1.9 KiB
Text

# format.ludic - a kind of file, the steps that carry it forward, and how one read went
# how a read ended; a game's own refusals (another map, another account) start at SAVE_STATUS_COUNT
export const SAVE_OK: int = 0
export const SAVE_NONE: int = 1 # there is no file
export const SAVE_CORRUPT: int = 2 # it did not parse, is cut off, or is not this kind of file
export const SAVE_FUTURE: int = 3 # written by a later build: refused, and never written over
export const SAVE_STATUS_COUNT: int = 4
# a kind of file: which migrations are its, what this build writes, the oldest it will carry forward,
# the key its version is under (a file without one is version 1), and whether an object is one at all
export property SaveFormat {
name: string = "",
version: int = 1,
oldest: int = 1,
version_key: string = "version",
is_one: fn(Val) -> bool = null
}
export function save_format(name: string, version: int) -> SaveFormat {
let f = new SaveFormat
f.name = name
f.version = version
return f
}
# One step: an object of `format` at version `from` rewritten in place into version from + 1. A
# version with no step is carried forward as it stands. The game writes these as defs.
export property SaveMigration {
key: string = "",
format: string = "",
from: int = 0,
run: fn(Val) -> void = null
}
export open registry SaveMigrations of SaveMigration as SMIG
# One read: what was found, the version it was written in, whether it had to be carried forward,
# whether it must never be written over, and whether it is the backup standing in for the file
export property SaveRead {
status: int = 0,
from: int = 0,
migrated: bool = false,
readonly: bool = false,
from_backup: bool = false,
intact: bool = true, # save_read: whether the text was whole (the words for a refusal)
value: Val = null
}
function read_new(status: int, v: Val) -> SaveRead {
let r = new SaveRead
r.status = status
r.value = v
return r
}