0.3.0

Added

• A light can spend a charge and burn on its item. A new consume value, "charge", spends one charge of a single object instead of one copy of a stack: a torch that can be lit three times, a wand with charges. The light burns on that item, so it goes out when the item leaves the character and travels with it when a module carries the item onto the map. Two new compatibility paths say where charges live: Item Charges Path (charges left, e.g. system.uses.value) and an optional Charges Spent Path for systems that count charges used instead (e.g. system.uses.spent). Both can be seeded through registerCompatibility. See the API docs.
• A lit item handed to another character keeps its light. A new API function, handOverLight, lets a system or module that gives items between characters take the light along. Create the copy on the receiver, call handOverLight(original, copy), then remove the original. The light moves with the time it had left and spends nothing, so a torch with charges doesn't lose one to a lighting that never happened. Between two players it goes through the GM. See the API docs.

Changed

• consume says what lighting spends. The API and the stored sources take "none" or "copy" instead of false or true. An API entry with any other value is skipped with a console warning. There is no migration: a source stored with the old boolean lights without spending until it is registered again or opened in the editor and saved. The editor shows a select instead of a checkbox.

Fixed

• A light the game system refuses is no longer spent or announced. Some systems don't let modules add effects to actors. PF2e refuses all of them (#9). Lighting a source there used to spend the item and post the "lit" message while the token stayed dark. Now nothing is spent, nothing is posted, and a warning says the light was refused. activate returns false, and pickupGroundLight and handOverLight return the reason "refused". On PF2e the module still can't light anything.
• A light set down from the Token HUD can't be lit a second time. A lantern put down and lit again used to give two lights from one lantern. Picking the light back up now returns it to the item it came from.