Log inGet started
World

Mill to Market: Production Buildings, Chains and Idle Earnings Kit

Merged

productionKit 1.4.0: welcome-back notes, a 'none' welcome style, and a display per building kind

#4
Author
claude-code @ auraAgent
Opened
Nov 14, 2026
From
contrib-4ax1ysbn
Into
main
Merged
Nov 14, 2026

What changed and why (found while making townKit's welcome back use productionKit's screens instead of drawing its own):

  1. Welcome-back notes. A summary may carry notes (strings, or { text, icon = resource id, svg, color }). Every welcome screen draws them in its own lettering: under the coins on the card, as a paragraph in the ledger, the first one under 'Away ...' on the toast, beneath the chest's goods, and in the report card's remarks. This lets a game tell the whole story of the time away (population, homes grown, taxes) on productionKit's screen.

  2. welcome = 'none'. The host shows no screen of its own for this style; the welcomeBack event still fires with the summary, so a game can merge its own numbers and call Production.showWelcome(summary, style) once. 'off' and 'hidden' already aliased to 'none' in pick(), so they now work for welcome too. Catalog entry and English strings added.

  3. A kind's own display. defineBuilding{ display = 'none' } is kept on the kind, and the host's styleOf() uses it when a building names no display of its own (per-building choice still wins, then the kind's, then setup's). townKit's homes make nothing, so they show no progress ring that would sit on top of the town's mood icons.

  4. Test isolation. 'words come from the translation catalogs' read the default town name while a game (townKit) may have set its own names earlier in the same session; it now clears them with Text.setTownNames({}) before checking the catalog names and restores the session's names after. The catalogue count test expects 6 welcome styles.

Tests: productionKitTests 33/33 in edit mode, including a new test that all five screens build with notes and that 'none' / 'off' / 'hidden' resolve. Seen in play in Thriving Town: the ledger welcome shows the town's notes and closes from its seal with a real click.

Source world: 3b494b6c-3abe-45a7-b1af-b8f85b677232 Contributed paths:

  • productionKit.package/ProductionHost.component/init.luau
  • productionKit.package/README.md
  • productionKit.package/catalog.module/init.luau
  • productionKit.package/locales/en/productionkit.json
  • productionKit.package/package.yaml
  • productionKit.package/productionKitTests.testSuite/init.luau
  • productionKit.package/screens.module/init.luau
  • productionKit.package
  • productionKit.package/ProductionHost.component
  • productionKit.package/catalog.module
  • productionKit.package/productionKitTests.testSuite
  • productionKit.package/screens.module
  • productionKit.package/ProductionBuilding.component/init.luau
  • productionKit.package/art.module/init.luau
  • productionKit.package/icons.module/init.luau
  • productionKit.package/production.module/init.luau
  • productionKit.package/works.module/init.luau

12 files changed

  • ChangedproductionKit.packageFolderBeforeAfter
  • ChangedproductionKit.package/ProductionHost.componentFolderBeforeAfter
  • ChangedproductionKit.package/ProductionHost.component/init.luau18.4 KB → 18.8 KBBeforeAfter
  • ChangedproductionKit.package/README.md43.8 KB → 44.7 KBBeforeAfter
  • ChangedproductionKit.package/catalog.moduleFolderBeforeAfter
  • ChangedproductionKit.package/catalog.module/init.luau29.5 KB → 30.0 KBBeforeAfter
  • ChangedproductionKit.package/locales/en/productionkit.json6.6 KB → 6.9 KBBeforeAfter
  • ChangedproductionKit.package/package.yaml1.0 KB → 1.0 KBBeforeAfter
  • ChangedproductionKit.package/productionKitTests.testSuiteFolderBeforeAfter
  • ChangedproductionKit.package/productionKitTests.testSuite/init.luau55.4 KB → 56.8 KBBeforeAfter
  • ChangedproductionKit.package/screens.moduleFolderBeforeAfter
  • ChangedproductionKit.package/screens.module/init.luau114 KB → 116 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.