changelog.txt

===[[[
This file contains changes specific to the df-structures repo. See
docs/changelog.txt in the dfhack repo for a full description, or
https://docs.dfhack.org/en/latest/docs/Compile.html#build-changelog

NOTE: currently, gen_changelog.txt expects a "Future" section to exist at the
top of this file (even if no changes are listed under it), or you will get a
"Entry without section" error. Also, to maintain proper sorting in the generated
changelogs when making a new release, docs/changelog.txt in the dfhack repo must
have the new release listed in the right place, even if no changes were made in
that repo.
]]]

# Future

## Structures
- corrected misalignment in ``historical_entity``
- partially identified squad-related structures in ``plotinfo`` and corrected position of ``civ_alert_idx`` (does not affect alignment)

# 50.05-alpha1

## Structures
- Renamed globals to match DF:
    - ``ui``: renamed to ``plotinfo``
    - ``ui_advmode``: renamed to ``adventure``
    - ``ui_build_selector``: renamed to ``buildreq``
    - ``ui_sidebar_menus``: renamed to ``game``
- ``building_civzonest``: identify two variables, ``dir_x`` and ``dir_y``, that handle archery range direction.

# 0.47.05-r8

## Structures
- ``unit_action_type_group``: added enum and tagged ``unit_action_type`` entries with its groups for DFHack's new action timer API.
- ``general_refst``: type virtual union member for ``ITEM_GENERAL``
- ``historical_figure_info.T_reputation.unk_2c``: identify ``year`` + ``year_ticks``
- ``itemst``: identify two vmethods related to adding thread improvements to items made of cloth, and label several previously unknown return types
- ``proj_magicst``: correct structure fields (to match 40d)
- ``world``: identify type of a vector (still not known what it's for, but it's definitely an item vector)

# 0.47.05-r7

## Structures
- Eliminate all "anon_X" names from structure fields
- ``army``: change ``squads`` vector type to ``world_site_inhabitant``, identify ``min_smell_trigger``+``max_odor_level``+``max_low_light_vision``+``sense_creature_classes``
- ``cave_column``: identify Z coordinates
- ``cave_column_rectangle``: identify coordinates
- ``embark_profile``: identify reclaim fields, add missing pet_count vector
- ``entity_population``: identify ``layer_id``
- ``feature``: identify "shiftCoords" vmethod, ``irritation_level`` and ``irritation_attacks`` fields
- ``flow_guide``: identify "shiftCoords" vmethod
- ``general_refst``: name parameters on ``getLocation`` and ``setLocation`` vmethods
- ``general_ref_locationst``: name member fields
- ``historical_entity``: confirm ``hostility_level`` and ``siege_tier``
- ``language_name_type``: identify ``ElfTree`` and ``SymbolArtifice`` thru ``SymbolFood``
- ``misc_trait_type``: update auto-decrement markers, remove obsolete references
- ``timed_event``: identify ``layer_id``
- ``ui``: identify actual contents of ``unk5b88`` field, identify infiltrator references
- ``ui_advmode``: identify several fields as containing coordinates
- ``ui_build_selector``: identify ``cur_walk_tag`` and ``min_weight_races``+``max_weight_races``
- ``unitst``: identify ``histeventcol_id`` field inside status2
- ``viewscreen_tradegoodsst``: rename trade_reply ``OffendedAnimal``+``OffendedAnimalAlt`` to ``OffendedBoth``+``OffendedAnimal``
- ``viewscreen_barterst``: name member fields
- ``world_site_inhabitant``: rename ``outcast_id`` and ``founder_outcast_entity_id``, identify ``interaction_id`` and ``interaction_effect_idx``
- ``item``: identify method ``notifyCreatedMasterwork`` that is called when a masterwork is created.

# 0.47.05-r6

## Structures
- ``art_image_elementst``: identify vmethod ``markDiscovered`` and second parameter for ``getName2``
- ``art_image_propertyst``: identify parameters for ``getName``
- ``building_handler``: fix vmethod ``get_machine_hookup_list`` parameters
- ``world.unk_26a9a8``: rename to ``allow_announcements``
- ``vermin``: identify ``category`` field as new enum

# 0.47.05-r5

## Structures
- ``adventure_optionst``: add missing ``getUnitContainer`` vmethod
- ``historical_figure.T_skills``: add ``account_balance`` field
- ``job``: add ``improvement`` field (union with ``hist_figure_id`` and ``race``)
- ``report_init.flags``: rename ``sparring`` flag to ``hostile_combat``
- ``viewscreen_loadgamest``: add missing ``LoadingImageSets`` and ``LoadingDivinationSets`` enum values to ``cur_step`` field

# 0.47.05-r4

## Structures
- ``unit.enemy``: fix definition of ``enemy_status_slot`` and add ``combat_side_id``
- ``historical_figure_info.spheres``: give spheres vector a usable name

# 0.47.05-r3

## Structures
- ``job_item``: identified several fields
- ``worldgen_parms``: moved to new struct type
- ``cursed_tomb``: new struct type
- ``ocean_wave_maker``: new struct type

# 0.47.05-r2

## Structures
- Identified remaining rhythm beat enum values
- ``ui_advmode.interactions``: identified some fields related to party members
- ``ui_advmode_menu``: identified several enum items
- ``ui_advmode``: identified several fields
- ``ui_advmode``: renamed ``wait`` to ``rest_mode`` and changed to an enum with correct values
- ``viewscreen_legendsst.cur_page``: added missing ``Books`` enum item, which fixes some other values

# 0.47.05-r1

## Structures
- ``viewscreen_loadgamest``: renamed ``cur_step`` enumeration to match style of ``viewscreen_adopt_regionst`` and ``viewscreen_savegamest``
- ``viewscreen_savegamest``: identified ``cur_step`` enumeration
- Identified scattered enum values (some rhythm beats, a couple of corruption unit thoughts, and a few language name categories)

# 0.47.05-beta1

## Structures
- Dropped support for 0.47.03-0.47.04

# 0.47.04-r5

## Structures
- ``job``: identified ``order_id`` field

# 0.47.04-r4

## Structures
- ``building_extents_type``: new enum, used for ``building_extents.extents``
- ``world_mountain_peak``: new struct (was previously inline) - used in ``world_data.mountain_peaks``

# 0.47.04-r3

## Structures
- ``history_event_masterpiece_createdst``: fixed alignment, including subclasses, and identified ``skill_at_time``
- ``item_body_component``: fixed some alignment issues and identified some fields (also applies to subclasses like ``item_corpsest``)
- ``stockpile_settings``: removed ``furniture.sand_bags`` (no longer present)

# 0.47.04-r2

## Fixes
- `embark-skills`: fixed an issue with structures causing the ``points`` option to do nothing

## Structures
- Added a new ``<df-other-vectors-type>``, which allows ``world.*.other`` collections of vectors to use the correct subtypes for items
- ``crime``: identified ``witnesses``, which contains the data held by the old field named ``reports``
- ``job_type``: added job types new to 0.47
- ``ui_advmode_menu``: identified some new enum items
- ``plant_raw``: material_defs now contains arrays rather than loose fields
- ``pronoun_type``: new enum (previously documented in field comments)
- ``creature_raw``: renamed ``gender`` to ``sex`` to match the field in ``unit``, which is more frequently used
- ``intrigue``: new type (split out from ``historical_figure_relationships``)
- ``setup_character_info``: fixed a couple alignment issues (needed by `embark-skills`)
- ``items_other_id``: removed ``BAD``, and by extension, ``world.items.other.BAD``, which was overlapping with ``world.items.bad``

# 0.47.04-r1

## Structures
- Added globals: ``cur_rain``, ``cur_rain_counter``, ``cur_snow``, ``cur_snow_counter``, ``weathertimer``, ``jobvalue``, ``jobvalue_setter``, ``interactitem``, ``interactinvslot``, ``handleannounce``, ``preserveannounce``, ``updatelightstate``
- ``agreement_details_data_plot_sabotage``: new struct type, along with related ``agreement_details_type.PlotSabotage``
- ``architectural_element``: new enum
- ``battlefield``: new struct type
- ``breed``: new struct type
- ``creature_handler``: identified vmethods
- ``crime``: removed fields of ``reports`` that are no longer present
- ``dance_form``: identified most fields
- ``history_event_context``: identified fields
- ``image_set``: new struct type
- ``itemdef_flags``: new enum, with ``GENERATED`` flag
- ``identity``: renamed ``civ`` to ``entity_id``, identified ``type``
- ``identity_type``: new enum
- ``interrogation_report``: new struct type
- ``justification``: new enum
- ``lever_target_type``: identified ``LeverMechanism`` and ``TargetMechanism`` values
- ``musical_form``: identified fields, including some renames. Also identified fields in ``scale`` and ``rhythm``
- ``region_weather``: new struct type
- ``squad_order_cause_trouble_for_entityst``: identified fields
- ``unit_thought_type``: added several new thought types
- ``viewscreen_workquota_detailsst``: identified fields

# 0.47.04-beta1

## Structures
- Added an XML schema for validating df-structures syntax
- Added ``divination_set_next_id`` and ``image_set_next_id`` globals
- ``activity_entry_type``: new enum type
- ``adventure_optionst``: identified many vmethods
- ``agreement_details``: identified most fields of most sub-structs
- ``artifact_claim``: identified several fields
- ``artifact_record``: identified several fields
- ``caste_raw_flags``: renamed and identified many flags to match information from Toady
- ``creature_raw_flags``: renamed and identified many flags to match information from Toady
- ``crime_type``: new enum type
- ``dfhack_room_quality_level``: added enum attributes for names of rooms of each quality
- ``entity_site_link_type``: new enum type
- ``export_map_type``: new enum type
- ``historical_entity.flags``: identified several flags
- ``historical_entity.relations``: renamed from ``unknown1b`` and identified several fields
- ``historical_figure.vague_relationships``: identified
- ``historical_figure_info.known_info``: renamed from ``secret``, identified some fields
- ``historical_figure``: renamed ``unit_id2`` to ``nemesis_id``
- ``history_event_circumstance_info``: new struct type (and changed several ``history_event`` subclasses to use this)
- ``history_event_reason_info``: new struct type (and changed several ``history_event`` subclasses to use this)
- ``honors_type``: identified several fields
- ``interaction_effect_create_itemst``: new struct type
- ``interaction_effect_summon_unitst``: new struct type
- ``item``: identified several vmethods
- ``layer_type``: new enum type
- ``plant.damage_flags``: added ``is_dead``
- ``plot_role_type``: new enum type
- ``plot_strategy_type``: new enum type
- ``relationship_event_supplement``: new struct type
- ``relationship_event``: new struct type
- ``specific_ref``: moved union data to ``data`` field
- ``ui_look_list``: moved union fields to ``data`` and renamed to match ``type`` enum
- ``ui_sidebar_menus.location``: added new profession-related fields, renamed and fixed types of deity-related fields
- ``ui_sidebar_mode``: added ``ZonesLocationInfo``
- ``unit_action``: rearranged as tagged union with new sub-types; existing code should be compatible
- ``vague_relationship_type``: new enum type
- ``vermin_flags``: identified ``is_roaming_colony``
- ``viewscreen_justicest``: identified interrogation-related fields
- ``world_data.field_battles``: identified and named several fields