Returns circuit names, lengths, bounds, sampled geometry counts and source control points from rainline.maps.catalog. Used before editing or rebuilding a layout.

Loads one selected circuit as the root editing scene using layers.load, builds its deterministic geometry, and saves it. Existing additive loads are replaced safely. Requires edit mode. Return to scenes.rainline for multiplayer play.

Edits an existing circuit control polygon in edit mode. Rejects non-finite coordinates, points less than 24 m apart and crossing segments. Preserves biome and road width. After editing, run firstLightMaps.rebuild and inspect the smoothed road visually.

# shared Cross-tool helpers for the firstLightMaps toolbox. Every tool inside the toolbox can pull these in with `require(".shared")`. Holds the small set of helpers that more than one tool needs — typically the `ok(value, formatted?)` / `fail(message, exitCode?)` constructors that produce the canonical `firstLightMapsToolResult` shape, plus any toolbox-wide parsers, validators, or shared state. Per-tool implementation stays inside each `<x>.tool/init.luau`; this module is not a place to forward logic from. ## Exports - `M.ok(value: any?, formatted: string?) -> firstLightMapsToolResult` — success envelope (`exitCode = 0`, `ok = true`). - `M.fail(message: string, exitCode: number?) -> firstLightMapsToolResult` — failure envelope (`exitCode` defaults to 1, `ok = false`). Types: - `firstLightMapsToolResult = { stdout: string, stderr: string, exitCode: number, ok: boolean, value: any? }` - `stdout` — human-readable formatted output; empty when the op produces no text. - `stderr` — error message on failure; empty on success. - `exitCode` — POSIX-style exit code: `0` success, `1` generic failure, `2` bad arguments. - `ok` — `true` iff `exitCode == 0`. - `value` — structured return from the underlying op; `nil` for void ops. ## Usage ```luau local shared = require(".shared") function M.someTool(args) if not args.id then return shared.fail("missing id", 2) end return shared.ok({ id = args.id }, "created " .. args.id) end ``` ## Notes - Pure constructors — no engine calls, no state. Safe to call from any context. - Tools that opt into this shape get a stable envelope every other tool in the toolbox can rely on. Tools that do something custom can return whatever shape they want — `firstLightMapsToolResult` is opt-in. - Per-tool implementations still own their own `--!desc` / `--!arg` / `--!return` / `--!example` annotations even when their result is constructed through these helpers.

# shared One-paragraph description of what this module provides and who consumes it. ## Exports - `M.exampleFn(arg) -> result` — what it does and when to call it. - `M.exampleValue: type` — what value it carries. ## Usage Replace `<identity>` with the string `asset.create` returned — this module's source path with `/` written as `.` and each segment's type suffix dropped, the way a module at `/source/lib/thing.module` is `lib.thing` and one at `/source/kit.package/thing.module` is `kit.thing`. ```luau local M = require("<identity>") M.exampleFn("foo") ``` ## Notes - Anything callers need to know about THIS module: required runtime ordering, state ownership, side effects.

Authoritative five-circuit catalogue: ids, names, descriptions, control polygons, biome and half-width. Consumed by rainline.shared, the circuit builder, selection menu and firstLightMaps tools.