=== Scroll down for changes

===[[[

The text below is included in docs/dev/Documentation.rst - see that file for more details on the changelog setup.

This is kept in this file as a quick syntax reference.

===help

changelog.txt uses a syntax similar to RST, with a few special sequences:

- ``===`` indicates the start of a comment

- ``#`` indicates the start of a release name (do not include "DFHack")

- ``##`` indicates the start of a section name (this must be listed in ``gen_changelog.py``)

- ``-`` indicates the start of a changelog entry. **Note:** an entry currently must be only one line.

- ``:`` (colon followed by space) separates the name of a feature from a description of a change to that feature.

Changes made to the same feature are grouped if they end up in the same section.

- ``:\`` (colon, backslash, space) avoids the above behavior

- ``- @`` (the space is optional) indicates the start of an entry that should only be displayed in NEWS-dev.rst.

Use this sparingly, e.g. for immediate fixes to one development build in another development build that

are not of interest to users of stable builds only.

- Three ``[`` characters indicate the start of a block (possibly a comment) that

spans multiple lines. Three ``]`` characters indicate the end of such a block.

- ``!`` immediately before a phrase set up to be replaced (see gen_changelog.py) stops that occurrence from being replaced.

===end

]]]

================================================================================

======== IMPORTANT: rename this, and add a new "future" section, BEFORE ========

======== making a new DFHack release, even if the only changes made ========

======== were in submodules with their own changelogs! ========

================================================================================

# Future

## New Plugins

## Fixes

## Misc Improvements

- Scrollable widgets now react to mouse wheel events when the mouse is over the widget

- the ``dfhack-config/scripts/`` folder is now searched for scripts by default

- `hotkeys`: overlay hotspot widget now shows the DFHack logo in graphics mode and "DFHack" in text mode

## Documentation

- `overlay-dev-guide`: added troubleshooting tips and common development workflows

- added DFHack architecture diagrams to the dev intro

## API

- ``Gui::getDwarfmodeDims``: now only returns map viewport dimensions; menu dimensions are obsolete

- ``Gui::getDFViewscreen``: returns the topmost underlying DF viewscreen

## Lua

- ``gui.View``: ``visible`` and ``active`` can now be functions that return a boolean

- ``widgets.Panel``: new attributes to control window dragging and resizing with mouse or keyboard

- ``widgets.Window``: Panel subclass with attributes preset for top-level windows

- ``widgets.CycleHotkeyLabel``: now supports rendering option labels in the color of your choice

- ``widgets.CycleHotkeyLabel``: new functions ``setOption()`` and ``getOptionPen()``

- ``widgets.ToggleHotkeyLabel``: now renders the ``On`` option in green text

- `overlay`: ``OverlayWidget`` now inherits from ``Panel`` instead of ``Widget`` to get all the frame and mouse integration goodies

- ``dfhack.gui.getDFViewscreen()``: returns the topmost underlying DF viewscreen

- ``gui.ZScreen``: Screen subclass that implements window raising, multi-viewscreen input handling, and viewscreen event pass-through so the underlying map can be interacted with and dragged around while DFHack screens are visible

- ``gui.View``: new function ``view:getMouseFramePos()`` for detecting whether the mouse is within (or over) the exterior frame of a view

## Internals

## Removed

- ``fix-job-postings`` from the `workflow` plugin is now obsolete since affected savegames can no longer be loaded

# 0.47.05-r8

## New Plugins

- `overlay`: plugin is transformed from a single line of text that runs `gui/launcher` on click to a fully-featured overlay injection framework. It now houses a popup menu for keybindings relevant to the current DF screen, all the widgets previously provided by `dwarfmonitor` (e.g. the current date and number of happy/unhappy dwarves), the overlay that highlights suspended buildings when you pause, and others. See `overlay-dev-guide` for details.

- `channel-safely`: auto-manage channel designations to keep dwarves safe

## Fixes

- `automaterial`: fix the cursor jumping up a z level when clicking quickly after box select

- `buildingplan`: fix crash when canceling out of placement mode for a building with planning mode enabled and subsequently attempting to place a building that does not have planning mode enabled and that has no pertinent materials available

- `gui/create-item`: prevent materials list filter from intercepting sublist hotkeys

- `mousequery`: fix the cursor jumping up z levels sometimes when using TWBT

- `tiletypes`: no longer resets dig priority to the default when updating other properties of a tile

- `automaterial`: fix rendering errors with box boundary markers

- `autolabor`, `autohauler`: properly handle jobs 241, 242, and 243

- `autofarm`: flush output so status text is visible immediately after running the command

- `hotkeys`: correctly detect hotkeys bound to number keys, F11, and F12

- `labormanager`: associate quern construction with the correct labor

- ``EventManager``: fix a segmentation fault with the ``REPORT`` event

- ``EventManager``: fix the ``JOB_STARTED`` event only sending events to the first handler listed instead of all registered handlers

- Core: ensure ``foo.init`` always runs before ``foo.*.init`` (e.g. ``dfhack.init`` should always run before ``dfhack.something.init``)

## Misc Improvements

- `autolabor`, `autohauler`: refactored to use DFHack's messaging system for info/debug/trace messages

- `blueprint`: new ``--smooth`` option for recording all smoothed floors and walls instead of just the ones that require smoothing for later carving

- `blueprint`: record built constructions in blueprints

- `blueprint`: record stockpile/building/zone names in blueprints

- `blueprint`: record room sizes in blueprints

- `blueprint`: generate meta blueprints to reduce the number of blueprints you have to apply

- `blueprint`: support splitting the output file into phases grouped by when they can be applied

- `blueprint`: when splitting output files, number them so they sort into the order you should apply them in

- `dwarfmonitor`: widgets have been ported to the overlay framework and can be enabled and configured via the `gui/overlay` UI

- `ls`: indent tag listings and wrap them in the rightmost column for better readability

- `ls`: new ``--exclude`` option for hiding matched scripts from the output. this can be especially useful for modders who don't want their mod scripts to be included in ``ls`` output.

- `hotkeys`: hotkey screen has been transformed into an interactive `overlay` widget that you can bring up by moving the mouse cursor over the hotspot (in the upper left corner of the screen by default). Enable/disable/reposition the hotspot in the `gui/overlay` UI. Even if the hotspot is disabled, the menu can be brought up at any time with the Ctrl-Shift-C hotkey.

- `hotkeys`: now supports printing active hotkeys to the console with ``hotkeys list``

- `digtype`: new ``-z`` option for digtype to restrict designations to the current z-level and down

- UX: List widgets now have mouse-interactive scrollbars

- UX: You can now hold down the mouse button on a scrollbar to make it scroll multiple times.

- UX: You can now drag the scrollbar up and down to scroll to a specific spot

- `orders`: replace shell craft orders in the standard orders list you get with ``orders import library/basic`` with orders for shell leggings. They have a slightly higher trade price. Also, "shleggings" is just hilarious.

- `spectate`: new ``auto-unpause`` option for auto-dismissal of announcement pause events (e.g. sieges).

- `spectate`: new ``auto-disengage`` option for auto-disengagement of plugin through player interaction whilst unpaused.

- `spectate`: new ``tick-threshold`` option for specifying the maximum time to follow the same dwarf

- `spectate`: new ``animals`` option for sometimes following animals

- `spectate`: new ``hostiles`` option for sometimes following hostiles

- `spectate`: new ``visiting`` option for sometimes following visiting merchants, diplomats or plain visitors

- `spectate`: added persistent configuration of the plugin settings

- `gui/cp437-table`: new global keybinding for the clickable on-screen keyboard for players with keyboard layouts that prevent them from using certain keys: Ctrl-Shift-K

- `quickfort-library-guide`: improved layout of marksdwarf barracks in the example Dreamfort blueprints

## Documentation

- `overlay-dev-guide`: documentation and guide for injecting functionality into DF viewscreens from Lua scripts and creating interactive overlay widgets

- ``dfhack.gui.revealInDwarfmodeMap``: document ``center`` bool for Lua API

## API

- ``Gui::anywhere_hotkey``: for plugin commands bound to keybindings that can be invoked on any screen

- ``Gui::autoDFAnnouncement``, ``Gui::pauseRecenter``: added functionality reverse-engineered from announcement code

- ``Gui::revealInDwarfmodeMap``: Now enforce valid view bounds when pos invalid, add variant accepting x, y, z

- ``Lua::PushInterfaceKeys()``: transforms viewscreen ``feed()`` keys into something that can be interpreted by lua-based widgets

- ``Lua::Push()``: now handles maps with otherwise supported keys and values

- Units module: added new predicates for:

- ``isUnitInBox()``

- ``isAnimal()``

- ``isVisiting()`` any visiting unit (diplomat, merchant, visitor)

- ``isVisitor()`` ie. not merchants or diplomats

- ``isInvader()``

- ``isDemon()`` returns true for unique/regular demons

- ``isTitan()``

- ``isMegabeast()``

- ``isGreatDanger()`` returns true if unit is a demon, titan, or megabeast

- ``isSemiMegabeast()``

- ``isNightCreature()``

- ``isDanger()`` returns true if is a 'GreatDanger', semi-megabeast, night creature, undead, or invader

- Units module: modified predicates:

- ``isUndead()`` now optionally ignores vampires instead of always ignoring vampires

- ``isCitizen()`` now optionally ignores insane citizens instead of always ignoring insane citizens

- Units module: new action timer API for speeding up of slowing down units

- Constructions module: added ``insert()`` to insert constructions into the game's sorted list.

- MiscUtils: added the following string transformation functions (refactored from ``uicommon.h``): ``int_to_string``, ``ltrim``, ``rtrim``, and ``trim``; added ``string_to_int``

## Lua

- ``widgets.Scrollbar``: new scrollbar widget that can be paired with an associated scrollable widget. Integrated with ``widgets.Label`` and ``widgets.List``.

- ``widgets.List``: new ``getIdxUnderMouse()`` function for detecting the list index under the active mouse cursor. this allows for "selection follows mouse" behavior

- ``widgets.List``: shift-clicking now triggers the ``submit2`` attribute function if it is defined

- ``dfhack.constructions.findAtTile()``: exposed preexisting function to Lua.

- ``dfhack.constructions.insert()``: exposed new function to Lua.

- ``widgets.Panel``: new ``frame_style`` and ``frame_title`` attributes for drawing frames around groups of widgets

- ``widgets.EditField``: now allows other widgets to process characters that the ``on_char`` callback rejects.

- ``widgets.FilteredList``: now provides a useful default search key for list items made up of text tokens instead of plain text

- ``widgets.ResizingPanel``: now accounts for frame inset when calculating frame size

- ``widgets.HotkeyLabel``: now ignores mouse clicks when ``on_activate`` is not defined

- ``gui.Screen.show()``: now returns ``self`` as a convenience

- ``gui.View.getMousePos()`` now takes an optional ``ViewRect`` parameter in case the caller wants to get the mouse pos relative to a rect that is not the frame_body (such as the frame_rect that includes the frame itself)

- Lua mouse events now conform to documented behavior in `lua-api` -- ``_MOUSE_L_DOWN`` will be sent exactly once per mouse click and ``_MOUSE_L`` will be sent repeatedly as long as the button is held down. Similarly for right mouse button events.

## Internals

- Constructions module: ``findAtTile`` now uses a binary search intead of a linear search

- MSVC warning level upped to /W3, and /WX added to make warnings cause compilations to fail.

## Removed

- `resume`: functionality (including suspended building overlay) has moved to `unsuspend`

# 0.47.05-r7

## New Plugins

- `autonestbox`: split off from `zone` into its own plugin. Note that to enable, the command has changed from ``autonestbox start`` to ``enable autonestbox``.

- `autobutcher`: split off from `zone` into its own plugin. Note that to enable, the command has changed from ``autobutcher start`` to ``enable autobutcher``.

- `overlay`: display a "DFHack" button in the lower left corner that you can click to start the new GUI command launcher. The `dwarfmonitor` weather display had to be moved to make room for the button. If you are seeing the weather indicator rendered over the overlay button, please remove the ``dfhack-config/dwarfmonitor.json`` file to fix the weather indicator display offset.

## New Internal Commands

- `tags`: new built-in command to list the tool category tags and their definitions. tags associated with each tool are visible in the tool help and in the output of `ls`.

## Fixes

- `autochop`: designate largest trees for chopping first, instead of the smallest

- ``dfhack.run_script``: ensure the arguments passed to scripts are always strings. This allows other scripts to call ``run_script`` with numeric args and it won't break parameter parsing.

- `dig-now`: Fix direction of smoothed walls when adjacent to a door or floodgate

- ``job.removeJob()``: ensure jobs are removed from the world list when they are canceled

- `quickfort`: `Dreamfort <quickfort-blueprint-guide>` blueprint set: declare the hospital zone before building the coffer; otherwise DF fails to stock the hospital with materials

- ``dfhack.buildings.findCivzonesAt``: no longer return duplicate civzones after loading a save with existing civzones

## Misc Improvements

- Init scripts: ``dfhack.init`` and other init scripts have moved to ``dfhack-config/init/``. If you have customized your ``dfhack.init`` file and want to keep your changes, please move the part that you have customized to the new location at ``dfhack-config/init/dfhack.init``. If you do not have changes that you want to keep, do not copy anything, and the new defaults will be used automatically.

- History files: ``dfhack.history``, ``tiletypes.history``, ``lua.history``, and ``liquids.history`` have moved to the ``dfhack-config`` directory. If you'd like to keep the contents of your current history files, please move them to ``dfhack-config``.

- `do-job-now`: new global keybinding for boosting the priority of the jobs associated with the selected building/work order/unit/item etc.: Alt-N

- `gui/workorder-details`: new keybinding on the workorder details screen: ``D``

- `keybinding`: support backquote (\`) as a hotkey (and assign the hotkey to the new `gui/launcher` interface)

- `ls`: can now filter tools by substring or tag. note that dev scripts are hidden by default. pass the ``--dev`` option to show them.

- `manipulator`: add a library of useful default professions

- `manipulator`: move professions configuration from ``professions/`` to ``dfhack-config/professions/`` to keep it together with other dfhack configuration. If you have saved professions that you would like to keep, please manually move them to the new folder.

- ``materials.ItemTraitsDialog``: added a default ``on_select``-handler which toggles the traits.

- `orders`: added useful library of manager orders. see them with ``orders list`` and import them with, for example, ``orders import library/basic``

- `prospect`: add new ``--show`` option to give the player control over which report sections are shown. e.g. ``prospect all --show ores`` will just show information on ores.

- `seedwatch`: ``seedwatch all`` now adds all plants with seeds to the watchlist, not just the "basic" crops.

- UX: You can now move the cursor around in DFHack text fields in ``gui/`` scripts (e.g. `gui/blueprint`, `gui/quickfort`, or `gui/gm-editor`). You can move the cursor by clicking where you want it to go with the mouse or using the Left/Right arrow keys. Ctrl+Left/Right will move one word at a time, and Alt+Left/Right will move to the beginning/end of the text.

- UX: You can now click on the hotkey hint text in many ``gui/`` script windows to activate the hotkey, like a button. Not all scripts have been updated to use the clickable widget yet, but you can try it in `gui/blueprint` or `gui/quickfort`.

- UX: Label widget scroll icons are replaced with scrollbars that represent the percentage of text on the screen and move with the position of the visible text, just like web browser scrollbars.

- `quickfort`: `Dreamfort <quickfort-blueprint-guide>` blueprint set improvements: set traffic designations to encourage dwarves to eat cooked food instead of raw ingredients

## Documentation

- Added `modding-guide`

- Update all DFHack tool documentation (300+ pages) with standard syntax formatting, usage examples, and overall clarified text.

- Group DFHack tools by `tag <tools>` so similar tools are grouped and easy to find

## API

- Removed "egg" ("eggy") hook support (Linux only). The only remaining method of hooking into DF is by interposing SDL calls, which has been the method used by all binary releases of DFHack.

- Removed ``Engravings`` module (C++-only). Access ``world.engravings`` directly instead.

- Removed ``Notes`` module (C++-only). Access ``ui.waypoints.points`` directly instead.

- Removed ``Windows`` module (C++-only) - unused.

- ``Constructions`` module (C++-only): removed ``t_construction``, ``isValid()``, ``getCount()``, ``getConstruction()``, and ``copyConstruction()``. Access ``world.constructions`` directly instead.

- ``Gui::getSelectedItem()``, ``Gui::getAnyItem()``: added support for the artifacts screen

- ``Units::teleport()``: now sets ``unit.idle_area`` to discourage units from walking back to their original location (or teleporting back, if using `fastdwarf`)

## Lua

- History: added ``dfhack.getCommandHistory(history_id, history_filename)`` and ``dfhack.addCommandToHistory(history_id, history_filename, command)`` so gui scripts can access a commandline history without requiring a terminal.

- Added ``dfhack.screen.hideGuard()``: exposes the C++ ``Screen::Hide`` to Lua

- ``helpdb``: database and query interface for DFHack tool help text

- ``tile-material``: fix the order of declarations. The ``GetTileMat`` function now returns the material as intended (always returned nil before). Also changed the license info, with permission of the original author.

- ``utils.df_expr_to_ref()``: fixed some errors that could occur when navigating tables

- ``widgets.EditField``: new ``onsubmit2`` callback attribute is called when the user hits Shift-Enter.

- ``widgets.EditField``: new function: ``setCursor(position)`` sets the input cursor.

- ``widgets.EditField``: new attribute: ``ignore_keys`` lets you ignore specified characters if you want to use them as hotkeys

- ``widgets.FilteredList``: new attribute: ``edit_ignore_keys`` gets passed to the filter EditField as ``ignore_keys``

- ``widgets.Label``: ``scroll`` function now interprets the keywords ``+page``, ``-page``, ``+halfpage``, and ``-halfpage`` in addition to simple positive and negative numbers.

- ``widgets.HotkeyLabel``: clicking on the widget will now call ``on_activate()``.

- ``widgets.CycleHotkeyLabel``: clicking on the widget will now cycle the options and trigger ``on_change()``. This also applies to the ``ToggleHotkeyLabel`` subclass.

# 0.47.05-r6

## Fixes

- `eventful`: fix ``eventful.registerReaction`` to correctly pass ``call_native`` argument thus allowing canceling vanilla item creation. Updated related documentation.

- `eventful`: renamed NEW_UNIT_ACTIVE event to UNIT_NEW_ACTIVE to match the ``EventManager`` event name

- `eventful`: fixed UNIT_NEW_ACTIVE event firing too often

- ``job.removeJob()``: fixes regression in DFHack 0.47.05-r5 where items/buildings associated with the job were not getting disassociated when the job is removed. Now `build-now` can build buildings and `gui/mass-remove` can cancel building deconstruction again

- ``widgets.CycleHotkeyLabel``: allow initial option values to be specified as an index instead of an option value

## Misc Improvements

- `confirm`: added a confirmation dialog for removing manager orders

- `confirm`: allow players to pause the confirmation dialog until they exit the current screen

- `dfhack-examples-guide`: refine food preparation orders so meal types are chosen intelligently according to the amount of meals that exist and the number of aviailable items to cook with

- `dfhack-examples-guide`: reduce required stock of dye for "Dye cloth" orders

- `dfhack-examples-guide`: fix material conditions for making jugs and pots

- `dfhack-examples-guide`: make wooden jugs by default to differentiate them from other stone tools. this allows players to more easily select jugs out with a properly-configured stockpile (i.e. the new ``woodentools`` alias)

- `quickfort-alias-guide`: new aliases: ``forbidsearch``, ``permitsearch``, and ``togglesearch`` use the `search-plugin` plugin to alter the settings for a filtered list of item types when configuring stockpiles

- `quickfort-alias-guide`: new aliases: ``stonetools`` and ``woodentools``. the ``jugs`` alias is deprecated. please use ``stonetools`` instead, which is the same as the old ``jugs`` alias.

- `quickfort-alias-guide`: new aliases: ``usablehair``, ``permitusablehair``, and ``forbidusablehair`` alter settings for the types of hair/wool that can be made into cloth: sheep, llama, alpaca, and troll. The ``craftrefuse`` aliases have been altered to use this alias as well.

- `quickfort-alias-guide`: new aliases: ``forbidthread``, ``permitthread``, ``forbidadamantinethread``, ``permitadamantinethread``, ``forbidcloth``, ``permitcloth``, ``forbidadamantinecloth``, and ``permitadamantinecloth`` give you more control how adamantine-derived items are stored

- `quickfort`: `Dreamfort <quickfort-blueprint-guide>` blueprint set improvements: automatically create tavern, library, and temple locations (restricted to residents only by default), automatically associate the rented rooms with the tavern

- `quickfort`: `Dreamfort <quickfort-blueprint-guide>` blueprint set improvements: new design for the services level, including were-bitten hospital recovery rooms and an appropriately-themed interrogation room next to the jail! Also fits better in a 1x1 embark for minimalist players.

## API

- ``word_wrap``: argument ``bool collapse_whitespace`` converted to enum ``word_wrap_whitespace_mode mode``, with valid modes ``WSMODE_KEEP_ALL``, ``WSMODE_COLLAPSE_ALL``, and ``WSMODE_TRIM_LEADING``.

## Lua

- ``gui.View``: all ``View`` subclasses (including all ``Widgets``) can now acquire keyboard focus with the new ``View:setFocus()`` function. See docs for details.

- ``materials.ItemTraitsDialog``: new dialog to edit item traits (where "item" is part of a job or work order or similar). The list of traits is the same as in vanilla work order conditions "``t`` change traits".

- ``widgets.EditField``: the ``key_sep`` string is now configurable

- ``widgets.EditField``: can now display an optional string label in addition to the activation key

- ``widgets.EditField``: views that have an ``EditField`` subview no longer need to manually manage the ``EditField`` activation state and input routing. This is now handled automatically by the new ``gui.View`` keyboard focus subsystem.

- ``widgets.HotkeyLabel``: the ``key_sep`` string is now configurable

# 0.47.05-r5

## New Plugins

- `spectate`: "spectator mode" -- automatically follows dwarves doing things in your fort

## New Tweaks

- `tweak`: ``partial-items`` displays percentage remaining for partially-consumed items such as hospital cloth

## Fixes

- `autofarm`: removed restriction on only planting "discovered" plants

- `cxxrandom`: fixed exception when calling ``bool_distribution``

- `luasocket`: return correct status code when closing socket connections so clients can know when to retry

## Misc Improvements

- `autochop`: only designate the amount of trees required to reach ``max_logs``

- `autochop`: preferably designate larger trees over smaller ones

- `blueprint`: ``track`` phase renamed to ``carve``

- `blueprint`: carved fortifications and (optionally) engravings are now captured in generated blueprints

- `cursecheck`: new option, ``--ids`` prints creature and race IDs of the cursed creature

- `debug`: DFHack log messages now have configurable headers (e.g. timestamp, origin plugin name, etc.) via the ``debugfilter`` command of the `debug` plugin

- `debug`: script execution log messages (e.g. "Loading script: dfhack_extras.init" can now be controlled with the ``debugfilter`` command. To hide the messages, add this line to your ``dfhack.init`` file: ``debugfilter set Warning core script``

- `dfhack-examples-guide`: add mugs to ``basic`` manager orders

- `dfhack-examples-guide`: ``onMapLoad_dreamfort.init`` remove "cheaty" commands and new tweaks that are now in the default ``dfhack.init-example`` file

- ``dfhack.init-example``: recently-added tweaks added to example ``dfhack.init`` file

- `dig-now`: handle fortification carving

- `EventManager`: add new event type ``JOB_STARTED``, triggered when a job first gains a worker

- `EventManager`: add new event type ``UNIT_NEW_ACTIVE``, triggered when a new unit appears on the active list

- `gui/create-item`: Added "(chain)" annotation text for armours with the [CHAIN_METAL_TEXT] flag set

- `manipulator`: tweak colors to make the cursor easier to locate

- `stocks`: allow search terms to match the full item label, even when the label is truncated for length

- `tweak`: ``stable-cursor`` now keeps the cursor stable even when the viewport moves a small amount

## Documentation

- add more examples to the plugin example skeleton files so they are more informative for a newbie

- `confirm`: correct the command name in the plugin help text

- `cxxrandom`: added usage examples

- ``Lua API.rst``: added ``isHidden(unit)``, ``isFortControlled(unit)``, ``getOuterContainerRef(unit)``, ``getOuterContainerRef(item)``

- `lua-string`: document DFHack string extensions (``startswith()``, ``endswith()``, ``split()``, ``trim()``, ``wrap()``, and ``escape_pattern()``)

- `quickfort-blueprint-guide`: added screenshots to the Dreamfort case study and overall clarified text

- `remote-client-libs`: add new Rust client library

- update download link and installation instructions for Visual C++ 2015 build tools on Windows

- update information regarding obtaining a compatible Windows build environment

## API

- add functions reverse-engineered from ambushing unit code: ``Units::isHidden()``, ``Units::isFortControlled()``, ``Units::getOuterContainerRef()``, ``Items::getOuterContainerRef()``

- ``Job::removeJob()``: use the job cancel vmethod graciously provided by The Toady One in place of a synthetic method derived from reverse engineering

## Lua

- `custom-raw-tokens`: library for accessing tokens added to raws by mods

- ``dfhack.units``: Lua wrappers for functions reverse-engineered from ambushing unit code: ``isHidden(unit)``, ``isFortControlled(unit)``, ``getOuterContainerRef(unit)``, ``getOuterContainerRef(item)``

- ``dialogs``: ``show*`` functions now return a reference to the created dialog

- ``dwarfmode.enterSidebarMode()``: passing ``df.ui_sidebar_mode.DesignateMine`` now always results in you entering ``DesignateMine`` mode and not ``DesignateChopTrees``, even when you looking at the surface (where the default designation mode is ``DesignateChopTrees``)

- ``dwarfmode.MenuOverlay``: if ``sidebar_mode`` attribute is set, automatically manage entering a specific sidebar mode on show and restoring the previous sidebar mode on dismiss

- ``dwarfmode.MenuOverlay``: new class function ``renderMapOverlay`` to assist with painting tiles over the visible map

- ``ensure_key``: new global function for retrieving or dynamically creating Lua table mappings

- ``safe_index``: now properly handles lua sparse tables that are indexed by numbers

- ``string``: new function ``escape_pattern()`` escapes regex special characters within a string

- ``widgets``: unset values in ``frame_inset`` table default to ``0``

- ``widgets``: ``FilteredList`` class now allows all punctuation to be typed into the filter and can match search keys that start with punctuation

- ``widgets``: minimum height of ``ListBox`` dialog is now calculated correctly when there are no items in the list (e.g. when a filter doesn't match anything)

- ``widgets``: if ``autoarrange_subviews`` is set, ``Panel``\s will now automatically lay out widgets vertically according to their current height. This allows you to have widgets dynamically change height or become visible/hidden and you don't have to worry about recalculating frame layouts

- ``widgets``: new class ``ResizingPanel`` (subclass of ``Panel``) automatically recalculates its own frame height based on the size, position, and visibility of its subviews

- ``widgets``: new class ``HotkeyLabel`` (subclass of ``Label``) that displays and reacts to hotkeys

- ``widgets``: new class ``CycleHotkeyLabel`` (subclass of ``Label``) allows users to cycle through a list of options by pressing a hotkey

- ``widgets``: new class ``ToggleHotkeyLabel`` (subclass of ``CycleHotkeyLabel``) toggles between ``On`` and ``Off`` states

- ``widgets``: new class ``WrappedLabel`` (subclass of ``Label``) provides autowrapping of text

- ``widgets``: new class ``TooltipLabel`` (subclass of ``WrappedLabel``) provides tooltip-like behavior

# 0.47.05-r4

## Fixes

- `blueprint`: fixed passing incorrect parameters to `gui/blueprint` when you run ``blueprint gui`` with optional params

- `blueprint`: key sequences for constructed walls and down stairs are now correct

- `tailor`: fixed some inconsistencies (and possible crashes) when parsing certain subcommands, e.g. ``tailor help``

- `tiletypes-here`, `tiletypes-here-point`: fix crash when running from an unsuspended core context

## Misc Improvements

- Core: DFHack now prints the name of the init script it is running to the console and stderr

- `automaterial`: ensure construction tiles are laid down in order when using `buildingplan` to plan the constructions

- `blueprint`: all blueprint phases are now written to a single file, using `quickfort` multi-blueprint file syntax. to get the old behavior of each phase in its own file, pass the ``--splitby=phase`` parameter to ``blueprint``

- `blueprint`: you can now specify the position where the cursor should be when the blueprint is played back with `quickfort` by passing the ``--playback-start`` parameter

- `blueprint`: generated blueprints now have labels so `quickfort` can address them by name

- `blueprint`: all building types are now supported

- `blueprint`: multi-type stockpiles are now supported

- `blueprint`: non-rectangular stockpiles and buildings are now supported

- `blueprint`: blueprints are no longer generated for phases that have nothing to do (unless those phases are explicitly enabled on the commandline or gui)

- `blueprint`: new "track" phase that discovers and records carved tracks

- `blueprint`: new "zone" phase that discovers and records activity zones, including custom configuration for ponds, gathering, and hospitals

- `dig-now`: no longer leaves behind a designated tile when a tile was designated beneath a tile designated for channeling

- `orders`: added ``list`` subcommand to show existing exported orders

- `quickfort`, `dfhack-examples-guide`: Dreamfort blueprint set improvements based on playtesting and feedback. includes updated profession definitions.

- `quickfort-library-guide`: added light aquifer tap and pump stack blueprints (with step-by-step usage guides) to the quickfort blueprint library

- `quickfort`: Dreamfort blueprint set improvements: added iron and flux stock level indicators on the industry level and a prisoner processing quantum stockpile in the surface barracks. also added help text for how to manage sieges and how to manage prisoners after a siege.

## API

- ``Buildings::findCivzonesAt()``: lookups now complete in constant time instead of linearly scanning through all civzones in the game

## Lua

- ``argparse.processArgsGetopt()``: you can now have long form parameters that are not an alias for a short form parameter. For example, you can now have a parameter like ``--longparam`` without needing to have an equivalent one-letter ``-l`` param.

- ``dwarfmode.enterSidebarMode()``: ``df.ui_sidebar_mode.DesignateMine`` is now a suported target sidebar mode

## Removed

- `fortplan`: please use `quickfort` instead

# 0.47.05-r3

## New Plugins

- `dig-now`: instantly completes dig designations (including smoothing and carving tracks)

## Fixes

- Core: ``alt`` keydown state is now cleared when DF loses and regains focus, ensuring the ``alt`` modifier state is not stuck on for systems that don't send standard keyup events in response to ``alt-tab`` window manager events

- Lua: ``memscan.field_offset()``: fixed an issue causing `devel/export-dt-ini` to crash sometimes, especially on Windows

- `autofarm`: autofarm will now count plant growths as well as plants toward its thresholds

- `autogems`: no longer assigns gem cutting jobs to workshops with gem cutting prohibited in the workshop profile

## Misc Improvements

- `buildingplan`: now displays which items are attached and which items are still missing for planned buildings

- `orders`: support importing and exporting reaction-specific item conditions, like "lye-containing" for soap production orders

- `orders`: new ``sort`` command. sorts orders according to their repeat frequency. this prevents daily orders from blocking other orders for simlar items from ever getting completed.

- `tiletypes-here`, `tiletypes-here-point`: add ``--cursor`` and ``--quiet`` options to support non-interactive use cases

- `quickfort`: Dreamfort blueprint set improvements: extensive revision based on playtesting and feedback. includes updated ``onMapLoad_dreamfort.init`` settings file, enhanced automation orders, and premade profession definitions. see full changelog at https://github.com/DFHack/dfhack/pull/1921 and https://github.com/DFHack/dfhack/pull/1925

- `tailor`: allow user to specify which materials to be used, and in what order

## API

- The ``Items`` module ``moveTo*`` and ``remove`` functions now handle projectiles

## Lua

- new global function: ``safe_pairs(iterable[, iterator_fn])`` will iterate over the ``iterable`` (a table or iterable userdata) with the ``iterator_fn`` (``pairs`` if not otherwise specified) if iteration is possible. If iteration is not possible or would throw an error, for example if ``nil`` is passed as the ``iterable``, the iteration is just silently skipped.

## Documentation

- `quickfort-library-guide`: updated dreamfort documentation and added screenshots

- `dfhack-examples-guide`: documentation for all of `dreamfort`'s supporting files (useful for all forts, not just Dreamfort!)

# 0.47.05-r2

## Fixes

- Fixed an issue where scrollable text in Lua-based screens could prevent other widgets from scrolling

- Fixed an issue preventing some external scripts from creating zones and other abstract buildings (see note about room definitions under "Internals")

- `buildingplan`: fixed an issue where planned constructions designated with DF's sizing keys (``umkh``) would sometimes be larger than requested

- `buildingplan`: fixed an issue preventing other plugins like `automaterial` from planning constructions if the "enable all" buildingplan setting was turned on

- `buildingplan`: made navigation keys work properly in the materials selection screen when alternate keybindings are used

- `command-prompt`: fixed issues where overlays created by running certain commands (e.g. `gui/liquids`, `gui/teleport`) would not update the parent screen correctly

- `dwarfvet`: fixed a crash that could occur with hospitals overlapping with other buildings in certain ways

- `orders`: fixed crash when importing orders with malformed IDs

- ``quickfortress.csv`` blueprint: fixed refuse stockpile config and prevented stockpiles from covering stairways

- `stonesense`: fixed a crash that could occur when ctrl+scrolling or closing the Stonesense window

- `embark-assistant`: fixed faulty early exit in first search attempt when searching for waterfalls

## Misc Improvements

- Added adjectives to item selection dialogs, used in tools like `gui/create-item` - this makes it possible to differentiate between different types of high/low boots, shields, etc. (some of which are procedurally generated)

- `blueprint`: made ``depth`` and ``name`` parameters optional. ``depth`` now defaults to ``1`` (current level only) and ``name`` defaults to "blueprint"

- `blueprint`: ``depth`` can now be negative, which will result in the blueprints being written from the highest z-level to the lowest. Before, blueprints were always written from the lowest z-level to the highest.

- `blueprint`: added the ``--cursor`` option to set the starting coordinate for the generated blueprints. A game cursor is no longer necessary if this option is used.

- `quickfort`: the Dreamfort blueprint set can now be comfortably built in a 1x1 embark

- `stonesense`: sped up startup time

- `tweak` hide-priority: changed so that priorities stay hidden (or visible) when exiting and re-entering the designations menu

- `embark-assistant`: slightly improved performance of surveying and improved code a little

## Lua

- new string utility functions:

- ``string:wrap(width)`` wraps a string at space-separated word boundaries

- ``string:trim()`` removes whitespace characters from the beginning and end of the string

- ``string:split(delimiter, plain)`` splits a string with the given delimiter and returns a table of substrings. if ``plain`` is specified and set to ``true``, ``delimiter`` is interpreted as a literal string instead of as a pattern (the default)

- new library: ``argparse`` is a collection of commandline argument processing functions

- ``gui.Painter``: fixed error when calling ``viewport()`` method

- ``gui.dwarfmode``: new function: ``enterSidebarMode(sidebar_mode, max_esc)`` which uses keypresses to get into the specified sidebar mode from whatever the current screen is

- `reveal`: now exposes ``unhideFlood(pos)`` functionality to Lua

- new utility function: ``utils.normalizePath()``: normalizes directory slashes across platoforms to ``/`` and coaleses adjacent directory separators

- ``argparse.processArgsGetopt()`` (previously ``utils.processArgsGetopt()``):

- now returns negative numbers (e.g. ``-10``) in the list of positional parameters instead of treating it as an option string equivalent to ``-1 -0``

- now properly handles ``--`` like GNU ``getopt`` as a marker to treat all further parameters as non-options

- now detects when required arguments to long-form options are missing

- `xlsxreader`: added Lua class wrappers for the xlsxreader plugin API

## API

- Added ``dfhack.units.teleport(unit, pos)``

- Added ``dfhack.maps.getPlantAtTile(x, y, z)`` and ``dfhack.maps.getPlantAtTile(pos)``, and updated ``dfhack.gui.getSelectedPlant()`` to use it

## Documentation

- Added more client library implementations to the `remote interface docs <remote-client-libs>`

## Internals

- The DFHack test harness is now much easier to use for iterative development. Configuration can now be specified on the commandline, there are more test filter options, and the test harness can now easily rerun tests that have been run before.

- The ``test/main`` command to invoke the test harness has been renamed to just ``test``

- Unit tests must now match any output expected to be printed via ``dfhack.printerr()``

- Unit tests now support fortress mode (allowing tests that require a fortress map to be loaded) - note that these tests are skipped by continuous integration for now, pending a suitable test fortress

- Unit tests can now use ``delay_until(predicate_fn, timeout_frames)`` to delay until a condition is met

- Room definitions and extents are now created for abstract buildings so callers don't have to initialize the room structure themselves

# 0.47.05-r1

## Fixes

- `confirm`: stopped exposing alternate names when convicting units

- `prospector`: improved pre embark rough estimates, particularly for small clusters

## Misc Improvements

- `autohauler`: allowed the ``Alchemist`` labor to be enabled in `manipulator` and other labor screens so it can be used for its intended purpose of flagging that no hauling labors should be assigned to a dwarf. Before, the only way to set the flag was to use an external program like Dwarf Therapist.

- `embark-assistant`: slightly improved performance of surveying

- `quickfort`: Dreamfort blueprint set improvements: `significant <http://www.bay12forums.com/smf/index.php?topic=176889.msg8239017#msg8239017>`_ refinements across the entire blueprint set. Dreamfort is now much faster, much more efficient, and much easier to use. The `checklist <https://docs.google.com/spreadsheets/d/13PVZ2h3Mm3x_G1OXQvwKd7oIR2lK4A1Ahf6Om1kFigw/edit#gid=1459509569>`__ now includes a mini-walkthrough for quick reference. The spreadsheet now also includes `embark profile suggestions <https://docs.google.com/spreadsheets/d/13PVZ2h3Mm3x_G1OXQvwKd7oIR2lK4A1Ahf6Om1kFigw/edit#gid=149144025>`__

- `quickfort`: added aliases for configuring masterwork and artifact core quality for all stockpile categories that have them; made it possible to take from multiple stockpiles in the ``quantumstop`` alias

## Documentation

- `fortplan`: added deprecation warnings - fortplan has been replaced by `quickfort`

# 0.47.05-beta1

## Fixes

- `embark-assistant`: fixed bug in soil depth determination for ocean tiles

- `orders`: don't crash when importing orders with malformed JSON

# 0.47.04-r5

## Fixes

- `embark-assistant`: fixed order of factors when calculating min temperature

- `embark-assistant`: improved performance of surveying

- `quickfort`: fixed eventual crashes when creating zones

- `quickfort`: fixed library aliases for tallow and iron, copper, and steel weapons

- `seedwatch`: fixed an issue where the plugin would disable itself on map load

- `search`: fixed crash when searching the ``k`` sidebar and navigating to another tile with certain keys, like ``<`` or ``>``

- `stockflow`: fixed ``j`` character being intercepted when naming stockpiles

- `stockpiles`: no longer outputs hotkey help text beneath `stockflow` hotkey help text

## Misc Improvements

- Lua label widgets (used in all standard message boxes) are now scrollable with Up/Down/PgUp/PgDn keys

- `autofarm`: now fallows farms if all plants have reached the desired count

- `buildingplan`: added ability to set global settings from the console, e.g. ``buildingplan set boulders false``

- `buildingplan`: added "enable all" option for buildingplan (so you don't have to enable all building types individually). This setting is not persisted (just like quickfort_mode is not persisted), but it can be set from onMapLoad.init

- `buildingplan`: modified ``Planning Mode`` status in the UI to show whether the plugin is in quickfort mode, "enable all" mode, or whether just the building type is enabled.

- `quickfort`: Dreamfort blueprint set improvements: added a streamlined checklist for all required dreamfort commands and gave names to stockpiles, levers, bridges, and zones

- `quickfort`: added aliases for bronze weapons and armor

- `quickfort`: added alias for tradeable crafts

## Lua

- ``dfhack.run_command()``: changed to interface directly with the console when possible, which allows interactive commands and commands that detect the console encoding to work properly

- ``processArgsGetopt()`` added to utils.lua, providing a callback interface for parameter parsing and getopt-like flexibility for parameter ordering and combination (see docs in ``library/lua/utils.lua`` and ``library/lua/3rdparty/alt_getopt.lua`` for details).

## Documentation

- Added documentation for Lua's ``dfhack.run_command()`` and variants

# 0.47.04-r4

## Fixes

- Fixed an issue on some Linux systems where DFHack installed through a package manager would attempt to write files to a non-writable folder (notably when running `exportlegends` or `gui/autogems`)

- `buildingplan`: fixed an issue preventing artifacts from being matched when the maximum item quality is set to ``artifacts``

- `buildingplan`: stopped erroneously matching items to buildings while the game is paused

- `buildingplan`: fixed a crash when pressing 0 while having a noble room selected

- `dwarfvet`: fixed a crash that could occur when discharging patients

- `dwarfmonitor`: fixed a crash when opening the ``prefs`` screen if units have vague preferences

- `embark-assistant`: fixed an issue causing incursion resource matching (e.g. sand/clay) to skip some tiles if those resources were provided only through incursions

- `embark-assistant`: corrected river size determination by performing it at the MLT level rather than the world tile level

- `search`: fixed an issue where search options might not display if screens were destroyed and recreated programmatically (e.g. with `quickfort`)

- `workflow`: fixed an error when creating constraints on "mill plants" jobs and some other plant-related jobs

- `zone`: fixed an issue causing the ``enumnick`` subcommand to run when attempting to run ``assign``, ``unassign``, or ``slaughter``

## Misc Improvements

- `buildingplan`: added support for all buildings, furniture, and constructions (except for instruments)

- `buildingplan`: added support for respecting building job_item filters when matching items, so you can set your own programmatic filters for buildings before submitting them to buildingplan

- `buildingplan`: changed default filter setting for max quality from ``artifact`` to ``masterwork``

- `buildingplan`: changed min quality adjustment hotkeys from 'qw' to 'QW' to avoid conflict with existing hotkeys for setting roller speed - also changed max quality adjustment hotkeys from 'QW' to 'AS' to make room for the min quality hotkey changes

- `buildingplan`: added a new global settings page accessible via the ``G`` hotkey when on any building build screen; ``Quickfort Mode`` toggle for legacy Python Quickfort has been moved to this page

- `buildingplan`: added new global settings for whether generic building materials should match blocks, boulders, logs, and/or bars - defaults are everything but bars

- `embark-assistant`: split the lair types displayed on the local map into mound, burrow, and lair

- `probe`: added more output for designations and tile occupancy

- `quickfort`: The Dreamfort sample blueprints now have complete walkthroughs for each fort level and importable orders that automate basic fort stock management

- `quickfort`: added more blueprints to the blueprints library: several bedroom layouts, the Saracen Crypts, and the complete fortress example from Python Quickfort: TheQuickFortress

## Documentation

- `quickfort-alias-guide`: alias syntax and alias standard library documentation for `quickfort` blueprints

- `quickfort-library-guide`: overview of the quickfort blueprint library

## API

- `buildingplan`: added Lua interface API

- ``dfhack.job.isSuitableMaterial()``: added an item type parameter so the ``non_economic`` flag can be properly handled (it was being matched for all item types instead of just boulders)

- ``Buildings::setSize()``: changed to reuse existing extents when possible

## Lua

- ``utils.addressof()``: fixed for raw userdata

# 0.47.04-r3

## New Plugins

- `xlsxreader`: provides an API for Lua scripts to read Excel spreadsheets

## Fixes

- `buildingplan`: fixed handling of buildings that require buckets

- `getplants`: fixed a crash that could occur on some maps

- `search`: fixed an issue causing item counts on the trade screen to display inconsistently when searching

- `stockpiles`: fixed a crash when loading food stockpiles

- `stockpiles`: fixed an error when saving furniture stockpiles

## Misc Improvements

- `createitem`: added support for plant growths (fruit, berries, leaves, etc.)

- `createitem`: added an ``inspect`` subcommand to print the item and material tokens of existing items, which can be used to create additional matching items

- `embark-assistant`: added support for searching for taller waterfalls (up to 50 z-levels tall)

- `search`: added support for searching for names containing non-ASCII characters using their ASCII equivalents

- `stocks`: added support for searching for items containing non-ASCII characters using their ASCII equivalents

- `zone`: added an ``enumnick`` subcommand to assign enumerated nicknames (e.g "Hen 1", "Hen 2"...)

- `zone`: added slaughter indication to ``uinfo`` output

## Documentation

- Fixed syntax highlighting of most code blocks to use the appropriate language (or no language) instead of Python

## API

- Added ``DFHack::to_search_normalized()`` (Lua: ``dfhack.toSearchNormalized()``) to convert non-ASCII alphabetic characters to their ASCII equivalents

# 0.47.04-r2

## New Tweaks

- `tweak` do-job-now: adds a job priority toggle to the jobs list

- `tweak` reaction-gloves: adds an option to make reactions produce gloves in sets with correct handedness

## Fixes

- Fixed a segfault when attempting to start a headless session with a graphical PRINT_MODE setting

- Fixed an issue with the macOS launcher failing to un-quarantine some files

- Linux: fixed ``dfhack.getDFPath()`` (Lua) and ``Process::getPath()`` (C++) to always return the DF root path, even if the working directory has changed

- `getplants`: fixed issues causing plants to be collected even if they have no growths (or unripe growths)

- `labormanager`: fixed handling of new jobs in 0.47

- `labormanager`: fixed an issue preventing custom furnaces from being built

- `embark-assistant`: fixed a couple of incursion handling bugs.

- Fixed ``Units::isEggLayer``, ``Units::isGrazer``, ``Units::isMilkable``, ``Units::isTrainableHunting``, ``Units::isTrainableWar``, and ``Units::isTamable`` ignoring the unit's caste

- `RemoteFortressReader`: fixed a couple crashes that could result from decoding invalid enum items (``site_realization_building_type`` and ``improvement_type``)

- `RemoteFortressReader`: fixed an issue that could cause block coordinates to be incorrect

- `rendermax`: fixed a hang that could occur when enabling some renderers, notably on Linux

- `stonesense`: fixed a crash when launching Stonesense

- `stonesense`: fixed some issues that could cause the splash screen to hang

## Misc Improvements

- Linux/macOS: Added console keybindings for deleting words (Alt+Backspace and Alt+d in most terminals)

- `blueprint`: now writes blueprints to the ``blueprints/`` subfolder instead of the df root folder

- `blueprint`: now automatically creates folder trees when organizing blueprints into subfolders (e.g. ``blueprint 30 30 1 rooms/dining dig`` will create the file ``blueprints/rooms/dining-dig.csv``); previously it would fail if the ``blueprints/rooms/`` directory didn't already exist

- `confirm`: added a confirmation dialog for convicting dwarves of crimes

- `manipulator`: added a new column option to display units' goals

## API

- Added ``Filesystem::mkdir_recursive``

- Extended ``Filesystem::listdir_recursive`` to optionally make returned filenames relative to the start directory

- ``Units``: added goal-related functions: ``getGoalType()``, ``getGoalName()``, ``isGoalAchieved()``

## Internals

- Added support for splitting scripts into multiple files in the ``scripts/internal`` folder without polluting the output of `ls`

## Lua

- Added a ``ref_target`` field to primitive field references, corresponding to the ``ref-target`` XML attribute

- Made ``dfhack.units.getRaceNameById()``, ``dfhack.units.getRaceBabyNameById()``, and ``dfhack.units.getRaceChildNameById()`` available to Lua

## Ruby

- Updated ``item_find`` and ``building_find`` to use centralized logic that works on more screens

## Documentation

- Expanded the installation guide

- Added some new dev-facing pages, including dedicated pages about the remote API, memory research, and documentation

- Made a couple theme adjustments

# 0.47.04-r1

## Fixes

- Fixed translation of certain types of in-game names

- Fixed a crash in ``find()`` for some types when no world is loaded

- `autogems`: fixed an issue with binned gems being ignored in linked stockpiles

- `stocks`: fixed display of book titles

- `tweak` embark-profile-name: fixed handling of the native shift+space key

## Misc Improvements

- ``dfhack.init-example``: enabled `autodump`

- `getplants`: added switches for designations for farming seeds and for max number designated per plant

- `manipulator`: added intrigue to displayed skills

- `search`: added support for the fortress mode justice screen

## API

- Added ``Items::getBookTitle`` to get titles of books. Catches titles buried in improvements, unlike getDescription.

## Lua

- ``pairs()`` now returns available class methods for DF types

# 0.47.04-beta1

## Fixes

- Fixed a crash when starting DFHack in headless mode with no terminal

## Misc Improvements

- Added "bit" suffix to downloads (e.g. 64-bit)

- Tests:

- moved from DF folder to hack/scripts folder, and disabled installation by default

- made test runner script more flexible

- `dfhack-run`: added color output support

- `embark-assistant`:

- updated embark aquifer info to show all aquifer kinds present

- added neighbor display, including kobolds (SKULKING) and necro tower count

- updated aquifer search criteria to handle the new variation

- added search criteria for embark initial tree cover

- added search criteria for necro tower count, neighbor civ count, and specific neighbors. Should handle additional entities, but not tested

## Internals

- Improved support for tagged unions, allowing tools to access union fields more safely

- Added separate changelogs in the scripts and df-structures repos

- Moved ``reversing`` scripts to df_misc repo

# 0.47.03-beta1

## New Scripts

- `devel/sc`: checks size of structures

- `devel/visualize-structure`: displays the raw memory of a structure

## Fixes

- @ `adv-max-skills`: fixed for 0.47

- `deep-embark`:

- prevented running in non-fortress modes

- ensured that only the newest wagon is deconstructed

- `full-heal`:

- fixed issues with removing corpses

- fixed resurrection for non-historical figures

- @ `modtools/create-unit`: added handling for arena tame setting

- `teleport`: fixed setting new tile occupancy

## Misc Improvements

- `deep-embark`:

- improved support for using directly from the DFHack console

- added a ``-clear`` option to cancel

- `exportlegends`:

- added identity information

- added creature raw names and flags

- `gui/prerelease-warning`: updated links and information about nightly builds

- `modtools/syndrome-trigger`: enabled simultaneous use of ``-synclass`` and ``-syndrome``

- `repeat`: added ``-list`` option

## Structures

- Dropped support for 0.44.12-0.47.02

- ``abstract_building_type``: added types (and subclasses) new to 0.47

- ``agreement_details_type``: added enum

- ``agreement_details``: added struct type (and many associated data types)

- ``agreement_party``: added struct type

- ``announcement_type``: added types new to 0.47

- ``artifact_claim_type``: added enum

- ``artifact_claim``: added struct type

- ``breath_attack_type``: added ``SHARP_ROCK``

- ``building_offering_placest``: new class

- ``building_type``: added ``OfferingPlace``

- ``creature_interaction_effect``: added subclasses new to 0.47

- ``creature_raw_flags``: identified several more items

- ``creature_raw_flags``: renamed many items to match DF names

- ``caste_raw_flags``: renamed many items to match DF names

- ``d_init``: added settings new to 0.47

- ``entity_name_type``: added ``MERCHANT_COMPANY``, ``CRAFT_GUILD``

- ``entity_position_responsibility``: added values new to 0.47

- ``fortress_type``: added enum

- ``general_ref_type``: added ``UNIT_INTERROGATEE``

- ``ghost_type``: added ``None`` value

- ``goal_type``: added goals types new to 0.47

- ``histfig_site_link``: added subclasses new to 0.47

- ``history_event_collection``: added subtypes new to 0.47

- ``history_event_context``: added lots of new fields

- ``history_event_reason``: added captions for all items

- ``history_event_reason``: added items new to 0.47

- ``history_event_type``: added types for events new to 0.47, as well as corresponding ``history_event`` subclasses (too many to list here)

- ``honors_type``: added struct type

- ``interaction_effect``: added subtypes new to 0.47

- ``interaction_source_experimentst``: added class type

- ``interaction_source_usage_hint``: added values new to 0.47

- ``interface_key``: added items for keys new to 0.47

- ``job_skill``: added ``INTRIGUE``, ``RIDING``

- ``lair_type``: added enum

- ``monument_type``: added enum

- ``next_global_id``: added enum

- ``poetic_form_action``: added ``Beseech``

- ``setup_character_info``: expanded significantly in 0.47

- ``text_system``: added layout for struct

- ``tile_occupancy``: added ``varied_heavy_aquifer``

- ``tool_uses``: added items: ``PLACE_OFFERING``, ``DIVINATION``, ``GAMES_OF_CHANCE``

- ``viewscreen_counterintelligencest``: new class (only layout identified so far)

# 0.44.12-r3

## New Plugins

- `autoclothing`: automatically manage clothing work orders

- `autofarm`: replaces the previous Ruby script of the same name, with some fixes

- `map-render`: allows programmatically rendering sections of the map that are off-screen

- `tailor`: automatically manages keeping your dorfs clothed

## New Scripts

- `assign-attributes`: changes the attributes of a unit

- `assign-beliefs`: changes the beliefs of a unit

- `assign-facets`: changes the facets (traits) of a unit

- `assign-goals`: changes the goals of a unit

- `assign-preferences`: changes the preferences of a unit

- `assign-profile`: sets a dwarf's characteristics according to a predefined profile

- `assign-skills`: changes the skills of a unit

- `combat-harden`: sets a unit's combat-hardened value to a given percent

- `deep-embark`: allows embarking underground

- `devel/find-twbt`: finds a TWBT-related offset needed by the new `map-render` plugin

- `dwarf-op`: optimizes dwarves for fort-mode work; makes managing labors easier

- `forget-dead-body`: removes emotions associated with seeing a dead body

- `gui/create-tree`: creates a tree at the selected tile

- `linger`: takes over your killer in adventure mode

- `modtools/create-tree`: creates a tree

- `modtools/pref-edit`: add, remove, or edit the preferences of a unit

- `modtools/set-belief`: changes the beliefs (values) of units

- `modtools/set-need`: sets and edits unit needs

- `modtools/set-personality`: changes the personality of units

- `modtools/spawn-liquid`: spawns water or lava at the specified coordinates

- `set-orientation`: edits a unit's orientation

- `unretire-anyone`: turns any historical figure into a playable adventurer

## Fixes

- Fixed a crash in the macOS/Linux console when the prompt was wider than the screen width

- Fixed some cases where Lua filtered lists would not properly intercept keys, potentially triggering other actions on the same screen

- Fixed inconsistent results from ``Units::isGay`` for asexual units

- `autofarm`:

- fixed biome detection to properly determine crop assignments on surface farms

- reimplemented as a C++ plugin to make proper biome detection possible

- `bodyswap`: fixed companion list not being updated often enough

- `cxxrandom`: removed some extraneous debug information

- `digfort`: now accounts for z-level changes when calculating maximum y dimension

- `embark-assistant`:

- fixed bug causing crash on worlds without generated metals (as well as pruning vectors as originally intended).

- fixed bug causing mineral matching to fail to cut off at the magma sea, reporting presence of things that aren't (like DF does currently).

- fixed bug causing half of the river tiles not to be recognized.

- added logic to detect some river tiles DF doesn't generate data for (but are definitely present).

- `eventful`: fixed invalid building ID in some building events

- `exportlegends`: now escapes special characters in names properly

- `getplants`: fixed designation of plants out of season (note that picked plants are still designated incorrectly)

- `gui/autogems`: fixed error when no world is loaded

- `gui/companion-order`:

- fixed error when resetting group leaders

- ``leave`` now properly removes companion links

- `gui/create-item`: fixed module support - can now be used from other scripts

- `gui/stamper`:

- stopped "invert" from resetting the designation type

- switched to using DF's designation keybindings instead of custom bindings

- fixed some typos and text overlapping

- `modtools/create-unit`:

- fixed an error associating historical entities with units

- stopped recalculating health to avoid newly-created citizens triggering a "recover wounded" job

- fixed units created in arena mode having blank names

- fixed units created in arena mode having the wrong race and/or interaction effects applied after creating units manually in-game

- stopped units from spawning with extra items or skills previously selected in the arena

- stopped setting some unneeded flags that could result in glowing creature tiles

- set units created in adventure mode to have no family, instead of being related to the first creature in the world

- `modtools/reaction-product-trigger`:

- fixed an error dealing with reactions in adventure mode

- blocked ``\\BUILDING_ID`` for adventure mode reactions

- fixed ``-clear`` to work without passing other unneeded arguments

- `modtools/reaction-trigger`:

- fixed a bug when determining whether a command was run

- fixed handling of ``-resetPolicy``

- `mousequery`: fixed calculation of map dimensions, which was sometimes preventing scrolling the map with the mouse when TWBT was enabled

- `RemoteFortressReader`:

- fixed a crash when a unit's path has a length of 0

- `stonesense`:

- fixed crash due to wagons and other soul-less creatures

- `tame`: now sets the civ ID of tamed animals (fixes compatibility with `autobutcher`)

- `title-folder`: silenced error when ``PRINT_MODE`` is set to ``TEXT``

## Misc Improvements

- Added a note to `dfhack-run` when called with no arguments (which is usually unintentional)

- On macOS, the launcher now attempts to un-quarantine the rest of DFHack

- `bodyswap`: added arena mode support

- `createitem`: added a list of valid castes to the "invalid caste" error message, for convenience

- `combine-drinks`: added more default output, similar to `combine-plants`

- `devel/export-dt-ini`: added more size information needed by newer Dwarf Therapist versions

- `dwarfmonitor`: enabled widgets to access other scripts and plugins by switching to the core Lua context

- `embark-assistant`:

- added an in-game option to activate on the embark screen

- changed waterfall detection to look for level drop rather than just presence

- changed matching to take incursions, i.e. parts of other biomes, into consideration when evaluating tiles. This allows for e.g. finding multiple biomes on single tile embarks.

- changed overlay display to show when incursion surveying is incomplete

- changed overlay display to show evil weather

- added optional parameter "fileresult" for crude external harness automated match support

- improved focus movement logic to go to only required world tiles, increasing speed of subsequent searches considerably

- `exportlegends`: added rivers to custom XML export

- `exterminate`: added support for a special ``enemy`` caste

- `gui/gm-unit`: added support for editing:

- added attribute editor

- added orientation editor

- added editor for bodies and body parts

- added color editor

- added belief editor

- added personality editor

- `modtools/create-item`:

- documented already-existing ``-quality`` option

- `modtools/create-unit`:

- added the ability to specify ``\\LOCAL`` for the fort group entity

- now enables the default labours for adult units with CAN_LEARN.

- now sets historical figure orientation.

- improved speed of creating multiple units at once

- made the script usable as a module (from other scripts)

- `modtools/reaction-trigger`:

- added ``-ignoreWorker``: ignores the worker when selecting the targets

- changed the default behavior to skip inactive/dead units; added ``-dontSkipInactive`` to include creatures that are inactive

- added ``-range``: controls how far elligible targets can be from the workshop

- syndromes now are applied before commands are run, not after

- if both a command and a syndrome are given, the command only runs if the syndrome could be applied

- `mousequery`: made it more clear when features are enabled

- `RemoteFortressReader`:

- added a basic framework for controlling and reading the menus in DF (currently only supports the building menu)

- added support for reading item raws

- added a check for whether or not the game is currently saving or loading, for utilities to check if it's safe to read from DF

- added unit facing direction estimate and position within tiles

- added unit age

- added unit wounds

- added tree information

- added check for units' current jobs when calculating the direction they are facing

## API

- Added ``Maps::GetBiomeType`` and ``Maps::GetBiomeTypeByRef`` to infer biome types properly

- Added ``Units::getPhysicalDescription`` (note that this depends on the ``unit_get_physical_description`` offset, which is not yet available for all DF builds)

- Added new ``plugin_load_data`` and ``plugin_save_data`` events for plugins to load/save persistent data

## Internals

- Added new Persistence module

- Persistent data is now stored in JSON files instead of historical figures - existing data will be migrated when saving

- Cut down on internal DFHack dependencies to improve build times

- Improved concurrency in event and server handlers

- `stonesense`: fixed some OpenGL build issues on Linux

## Lua

- Exposed ``gui.dwarfmode.get_movement_delta`` and ``gui.dwarfmode.get_hotkey_target``

- ``dfhack.run_command`` now returns the command's return code

## Ruby

- Made ``unit_ishostile`` consistently return a boolean

## Structures

- Added ``unit_get_physical_description`` function offset on some platforms

- Added/identified types:

- ``assume_identity_mode``

- ``musical_form_purpose``

- ``musical_form_style``

- ``musical_form_pitch_style``

- ``musical_form_feature``

- ``musical_form_vocals``

- ``musical_form_melodies``

- ``musical_form_interval``

- ``unit_emotion_memory``

- ``twbt_render_map``: added for 64-bit 0.44.12 (for `map-render`)

- ``personality_facet_type``, ``value_type``: added ``NONE`` values

- ``need_type``: fixed ``PrayOrMeditate`` typo

# 0.44.12-r2

## New Plugins

- `debug`: manages runtime debug print category filtering

- `nestboxes`: automatically scan for and forbid fertile eggs incubating in a nestbox

## New Scripts

- `devel/query`: searches for field names in DF objects

- `extinguish`: puts out fires

- `tame`: sets tamed/trained status of animals

## Fixes

- `building-hacks`: fixed error when dealing with custom animation tables

- `devel/test-perlin`: fixed Lua error (``math.pow()``)

- `embark-assistant`: fixed crash when entering finder with a 16x16 embark selected, and added 16 to dimension choices

- `embark-skills`: fixed missing ``skill_points_remaining`` field

- `full-heal`:

- stopped wagon resurrection

- fixed a minor issue with post-resurrection hostility

- `gui/companion-order`:

- fixed issues with printing coordinates

- fixed issues with move command

- fixed cheat commands (and removed "Power up", which was broken)

- `gui/gm-editor`: fixed reinterpret cast (``r``)

- `gui/pathable`: fixed error when sidebar is hidden with ``Tab``

- `labormanager`:

- stopped assigning labors to ineligible dwarves, pets, etc.

- stopped assigning invalid labors

- added support for crafting jobs that use pearl

- fixed issues causing cleaning jobs to not be assigned

- added support for disabling management of specific labors

- `prospector`: (also affected `embark-tools`) - fixed a crash when prospecting an unusable site (ocean, mountains, etc.) with a large default embark size in d_init.txt (e.g. 16x16)

- `siege-engine`: fixed a few Lua errors (``math.pow()``, ``unit.relationship_ids``)

- `tweak`: fixed ``hotkey-clear``

## Misc Improvements

- `armoks-blessing`: improved documentation to list all available arguments

- `devel/export-dt-ini`:

- added viewscreen offsets for DT 40.1.2

- added item base flags offset

- added needs offsets

- `embark-assistant`:

- added match indicator display on the right ("World") map

- changed 'c'ancel to abort find if it's under way and clear results if not, allowing use of partial surveys.

- added Coal as a search criterion, as well as a coal indication as current embark selection info.

- `full-heal`:

- added ``-all``, ``-all_civ`` and ``-all_citizens`` arguments

- added module support

- now removes historical figure death dates and ghost data

- `growcrops`: added ``all`` argument to grow all crops

- `gui/load-screen`: improved documentation

- `labormanager`: now takes nature value into account when assigning jobs

- `open-legends`: added warning about risk of save corruption and improved related documentation

- `points`: added support when in ``viewscreen_setupdwarfgamest`` and improved error messages

- `siren`: removed break handling (relevant ``misc_trait_type`` was no longer used - see "Structures" section)

## Internals

- Linux/macOS: changed recommended build backend from Make to Ninja (Make builds will be significantly slower now)

- Added a usable unit test framework for basic tests, and a few basic tests

- Core: various thread safety and memory management improvements

- Fixed CMake build dependencies for generated header files

- Fixed custom ``CMAKE_CXX_FLAGS`` not being passed to plugins

- Changed ``plugins/CMakeLists.custom.txt`` to be ignored by git and created (if needed) at build time instead

- Added ``CMakeSettings.json`` with intellisense support

## Lua

- ``utils``: new ``OrderedTable`` class

## Structures

- Win32: added missing vtables for ``viewscreen_storesst`` and ``squad_order_rescue_hfst``

- ``activity_event_performancest``: renamed poem as written_content_id

- ``dance_form``: named musical_form_id and musical_written_content_id

- ``incident_sub6_performance.participants``: named performance_event and role_index

- ``incident_sub6_performance``: made performance_event an enum

- ``incident_sub6_performance``: named poetic_form_id, musical_form_id, and dance_form_id

- ``musical_form_instruments``: named minimum_required and maximum_permitted

- ``musical_form``: named voices field

- ``poetic_form``: identified many fields and related enum/bitfield types

- ``setup_character_info``: identified ``skill_points_remaining`` (for `embark-skills`)

- ``unit_thought_type``: added new expulsion thoughts from 0.44.12

- ``viewscreen_layer_militaryst``: identified ``equip.assigned.assigned_items``

- ``world_data``: added ``mountain_peak_flags`` type, including ``is_volcano``

- ``written_content``: named poetic_form

- ``unit_action.attack``: identified ``attack_skill``

- ``unit_action.attack``: added ``lightly_tap`` and ``spar_report`` flags

- ``misc_trait_type``: removed ``LikesOutdoors``, ``Hardened``, ``TimeSinceBreak``, ``OnBreak`` (all unused by DF)

- ``unit_personality``: identified ``stress_drain``, ``stress_boost``, ``likes_outdoors``, ``combat_hardened``

- ``plant_tree_tile``: gave connection bits more meaningful names (e.g. ``connection_east`` instead of ``thick_branches_1``)

- ``plant_tree_info``: identified ``extent_east``, etc.

- ``ui``: fixed alignment of ``main`` and ``squads`` (fixes `tweak` hotkey-clear and DF-AI)

- ``ui.main``: identified ``fortress_site``

- ``ui.squads``: identified ``kill_rect_targets_scroll``

- ``world_site``: identified names and/or types of some fields

- ``world_history``: identified names and/or types of some fields