Stored Program Controls - Changelog

Version 1.0.0 — Help System & User-Authored Docs

Rich In-Game Help Pages

• The Block Help dialog now supports structured multi-section pages that can mix headers, paragraphs, logic tables, and diagrams in any order authored. Built-in help entries have been rewritten to use this new layout where appropriate.
• Connection / parameter tables gained a third column: Signal Type. Every row now shows its port classification (Digital, Analog, Integer, Decimal, String, Item, Item ID, Parameter, or Other) between the name and the description, so you can see at a glance what each port accepts.
• Parameters (settings configured inside the block, with no visible port) appear as dedicated rows in the same table under the "Parameter" signal type, instead of being buried in prose.
• Help pages can now embed captioned PNG diagrams. All built-in nodes whose behavior benefits from a picture (timers, counters, PID, etc.) have received diagrams; every one of the 110+ built-in nodes has had its help entry audited and updated with signal types and parameter rows where applicable.

User-Defined Function (UDF) Custom Help Pages

• Every User-Defined Function can now carry its own help page. Opening a UDF in the function editor shows an "Edit Help Page..." button in the top bar that launches a full-screen help editor with a toolbar.
• A lightweight markup language is parsed when rendering the help page:

  Section Title → level-2 header

  [[table]] ... [[/table]] → 3-column connection/parameter table (Name | Signal Type | Description — one row per line, pipe-separated) blank lines → paragraph separators
• Toolbar shortcuts in the help editor insert the correct markup at the cursor: "Insert Title" stamps a ## header, "Insert Table" stamps a ready-to-fill [[table]]...[[/table]] block with an example row.
• When a player clicks the help icon on a UDF call node (or on its palette entry), the editor reads the help text live from the on-disk .mclsc function file first, so docs stay in sync with the current saved version of the function even when older programs still embed an older inline snapshot.
• If no help text has been authored for a UDF, no auto-generated boilerplate "description" or synthetic input/output table is shown; the page simply renders whatever the function author wrote (including nothing, if that's what they wrote).

UI Polish

• The function editor's "Edit Help Page..." target has been restyled from a flat text field into a raised button with bevel highlights and a hover state, so it's visually distinct from the nearby input fields.
• While the help-text editor is focused, single-letter editor shortcuts (E, Delete, etc.) no longer leak through to the underlying editor — typed characters are captured by the text area instead of triggering editor actions or closing the screen.
• Fixed a z-order glitch where the MultiLineEditBox caret and selection could render behind the dialog chrome at certain scroll positions.

Bug Fixes

• Clicking the help icon on a UDF call entry in the palette now opens the correct per-function help page (previously fell back to a generic "udf_call" entry because the palette typeId includes a ::functionId suffix that the resolver wasn't stripping).
• The help dialog no longer emits an empty "Short description" header when the entry's short description is blank.
• UDF help text read from the on-disk function file now takes priority over any stale inline snapshot embedded in a program that was saved before the function's help was last edited.

For Addon Developers

• API bumped to version 1.2.0: new package com.hypernova.spc.api.help (SpcHelpRegistry, SpcHelpPage, SpcHelpSignalType, SpcHelpRow, SpcHelpLogicTable, SpcHelpDiagram) lets addons ship the same rich help pages used by built-in blocks. See API_CHANGELOG.txt for the full API change list. Fully backwards-compatible with 1.1.6 addons.