@idosgames/game-kit 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { W as World, A as ArtLook, E as Entity, a as ActorAct, F as FxEvent, b as ActorPose, c as ComponentType, C as CastDef } from './view-CS-ixOId.cjs';
+import { W as World, C as CastDef, A as ArtLook, E as Entity, a as ActorAct, F as FxEvent, b as ActorPose, c as ComponentType } from './view-CS-ixOId.cjs';
 export { D as DEFAULT_CAST, d as DEFAULT_LOOK, e as DEFAULT_PALETTE, f as EventHandler, g as FX_TOPIC, I as INPUT_TOPIC, h as InputEvent, R as Rng, S as System, i as Transform, T as TransformData, j as VIEW_RESIZED_TOPIC, k as Visual, V as VisualData, l as WorldOptions, m as WorldVar, n as createFixedStepper, o as createRng, p as defineComponent, q as mergePalette, r as resolveColor } from './view-CS-ixOId.cjs';
 
 /** Every entry has a stable id and a version (bumped on an incompatible change of the entry). */
@@ -181,6 +181,14 @@ interface ModeSpec {
     readonly blockParams?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
     /** Rules of this mode, after the preset's own. */
     readonly rules?: readonly RuleDef[];
+    /**
+     * Which rows of the genre's own lists this game leaves out (tuning knobs, 08.11.2026): `{ "powers":
+     * { "without": ["flight"] } }`. The kinds are the genre's (runner: powers, obstacles; survivors:
+     * foes). A block never ends up with nothing: leaving out every row of a kind keeps them all.
+     */
+    readonly content?: Readonly<Record<string, Readonly<{
+        without?: readonly string[];
+    }>>>;
 }
 interface ResourceSpec {
     /** Snake-case id, readable in formulas as `res.<id>`. */
@@ -233,6 +241,8 @@ interface GameSpec {
     readonly palette?: Readonly<Record<string, string>>;
     /** Text key → language → text: `{ "title": { "en": "Lava Run", "ru": "Лавовый забег" } }`. */
     readonly texts?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** Who the actors are, over the asset pack's cast, role by role: `{ "hero": { "preset": "viking", "races": ["dwarf"] } }`. */
+    readonly cast?: Readonly<Record<string, Partial<CastDef>>>;
     readonly rewards?: RewardsSpec;
     readonly multiplayer?: "none" | "async" | "coop" | "pvp";
     /** Unknown fields are kept. */
@@ -247,7 +257,14 @@ interface ResolvedMode {
     readonly blockParams: Readonly<Record<string, Readonly<Record<string, ParamValue>>>>;
     /** Preset rules, then the mode's own. */
     readonly rules: readonly RuleDef[];
+    /** Kind → the row ids this game leaves out (see ModeSpec.content); read through `contentOf`. */
+    readonly content: Readonly<Record<string, readonly string[]>>;
 }
+/**
+ * The rows of a genre list this mode plays with: `all` without the ones the spec leaves out. Never
+ * empty: a spec that leaves out every row keeps them all (a game must stay playable).
+ */
+declare function contentOf<T extends string>(mode: Pick<ResolvedMode, "content"> | undefined, kind: string, all: readonly T[]): readonly T[];
 interface ResolvedSpec {
     readonly spec: GameSpec;
     readonly engine: Engine;
@@ -318,7 +335,7 @@ interface PresetDef extends RegistryEntry {
     readonly name?: string;
     /** Block ids in setup order. */
     readonly blocks: readonly string[];
-    /** The preset's own parameters (what Jev's Score questions and the config agent set). */
+    /** The preset's own parameters (what the decision model's score questions and the config agent set). */
     readonly params?: ParamDefs;
     /**
      * Values the preset gives its blocks' parameters: `{ "waves": { "count": 10 } }`. For a number or
@@ -1137,9 +1154,12 @@ interface TdLevel {
     readonly enemies: readonly string[];
     readonly firstClearGold: number;
 }
-/** The waves of a level: a budget a wave, spent on the foes open by then; the new foe shows itself early. */
-declare function wavesOf(level: number, entries: number): WaveDef[];
-declare function levelOf$3(level: number, difficulty?: number): TdLevel;
+/**
+ * The waves of a level: a budget a wave, spent on the foes open by then; the new foe shows itself early.
+ * `foes`: the wave foes this game plays with (GameSpec content), every one when omitted.
+ */
+declare function wavesOf(level: number, entries: number, foes?: readonly string[]): WaveDef[];
+declare function levelOf$3(level: number, difficulty?: number, foes?: readonly string[]): TdLevel;
 /** Stars needed to play a level (its world's gate). */
 declare const tdStarsToEnter: (level: number) => number;
 /** The stars a cleared level gives by the lives kept: all of them nearly — three. */
@@ -1838,4 +1858,175 @@ declare function specForPreset(presetId: string, options?: {
     coinRef?: string;
 }): GameSpec;
 
-export { ABILITIES, ART, ASSET_PACKS, type AbilityId, ActorAct, ActorPose, type ArtContext, type ArtDef, ArtLook, type AssetPackDef, BLOCKS, BOSS_DEFEATED, BOSS_SPAWNED, BRANCH_LEVEL, type BlockContext, type BlockDef, type Board, Body, Bullet, CHAPTERS, CORE_EFFECTS, CastDef, ComponentType, type Controls, DEFAULT_REWARDS, DEMO_SPEC, type DamageType, type DefineOptions, Drop, EFFECTS, ENEMIES$1 as ENEMIES, ENGINES, ENTRY_ID_RE, type EffectContext, type EffectDef, type EffectSpec, type EnemyDef$1 as EnemyDef, type Engine, Entity, type Expr, ExprError, type ExprScope, type ExprValue, FOES, FUNCTIONS, type FlowSpec, Foe, type FoeKind, FxEvent, GIVE_UP, type GameSpec, Gem, HEROES, type HeroDef, type Issue, Jumper, KNOWN_SYSTEMS, type KindGrid, LEVELS_PER_WORLD, LEVEL_CLEARED, LEVEL_MAPS, LEVEL_UP, LINKS, type LinkDef, type EnemyDef as M3EnemyDef, type GoalDef$1 as M3GoalDef, type M3HeroDef, type M3Level, type LevelDef$2 as M3LevelDef, type SkillDef$2 as M3SkillDef, M3_CHARACTER, ELEMENTS as M3_ELEMENTS, ENEMIES as M3_ENEMIES, M3_HEROES, M3_LEVELS, M3_LEVELS_PER_WORLD, LEVELS$2 as M3_LEVEL_DEFS, M3_META, M3_META_STATS, OBSTACLES$1 as M3_OBSTACLES, PIECES as M3_PIECES, SKILLS$2 as M3_SKILLS, SPECIALS as M3_SPECIALS, M3_WORLDS, M3_WORLD_STARS, MAPS, MAP_COLS, MAP_ROWS, MAX_LEVEL, MAX_PASSIVES, MAX_WEAPONS, META_CHARACTER, META_STATS, BOARDS as MG_BOARDS, CHAINS as MG_CHAINS, MG_CHARACTER, MG_COLS, MG_HEROES, MG_LEVELS, MG_LEVELS_PER_WORLD, LEVELS$1 as MG_LEVEL_DEFS, MG_META, MG_META_STATS, OBSTACLES as MG_OBSTACLES, MG_REVIVE_ENERGY, MG_ROWS, SKILLS$1 as MG_SKILLS, SPECIAL_ITEMS as MG_SPECIAL_ITEMS, MG_WORLDS, MG_WORLD_STARS, type MapDef, type MergeHeroDef, MergeItem, type MergeLevel, type MetaGameDef, type MetaHeroDef, type MetaStatDef, type ChainDef as MgChainDef, type LevelDef$1 as MgLevelDef, type ObstacleDef as MgObstacleDef, type OrderDef as MgOrderDef, type SkillDef$1 as MgSkillDef, type SpecialItemDef as MgSpecialItemDef, type WantDef as MgWantDef, Missile, type ModeSpec, type NumberOrFormula, OBSTACLE_KINDS, type ObstacleKind, Order, PASSIVES, PASSIVE_IDS, PIECE_COLORS, PLATFORMER_CHARACTER, PLATFORMER_HEROES, PLATFORMER_LEVELS, PLATFORMER_META, PLATFORMER_META_STATS, PLATFORM_LINKS, PLATFORM_PACKS, PLATFORM_PRESETS, POWERS, POWER_IDS, PRESETS, type ParamDef, type ParamDefs, type ParamValue, type PassiveDef, type PassiveId, type PlatformerHeroDef, type PlatformerLevel, type PlatformerPerk, type PowerDef, type PowerId, type PresetDef, REROLL_GEMS, REVIVE, REVIVE_GEMS, REVIVE_OFFER, ROOMS, ROOM_ROWS, ROUND_ENDED, ROUND_OVER, ROUND_STARTED, RUNNER_CHARACTER, RUNNER_HEROES, RUNNER_LEVELS, RUNNER_META, RUNNER_META_STATS, Raider, type Registry, type RegistryEntry, type RegistryKind, type ResolvedMode, type ResolvedSpec, type ResourceSpec, type RewardedPlacementDef, type RewardsSpec, RoadItem, type RoomDef, type RoomFeature, type RoundState, type RuleDef, Runner, type RunnerHeroDef, type RunnerLevel, type RunnerPerk, type RunningMode, SELL_SHARE, SHOW_START, SPEC_VERSION, SPELLS, START_ROUND, SURVIVORS_META, Shot, Soldier, type SpecResult, type SpellDef, Spot, type StartModeOptions, Survivor, type SurvivorsBuild, TD_CHARACTER, TD_HEROES, TD_LEVELS, TD_LEVELS_PER_WORLD, TD_LIVES, TD_META, TD_META_STATS, REVIVE_LIVES as TD_REVIVE_LIVES, TD_WORLDS, TD_WORLD_STARS, TOWERS, BUSINESSES as TY_BUSINESSES, TY_CHARACTER, EVENTS as TY_EVENTS, TY_HEROES, TY_LEVELS, TY_LEVELS_PER_WORLD, LEVELS as TY_LEVEL_DEFS, TY_META, TY_META_STATS, MILESTONES as TY_MILESTONES, TY_REVIVE_SECONDS, SKILLS as TY_SKILLS, UPGRADES as TY_UPGRADES, TY_WORLDS, TY_WORLD_STARS, type TdHeroDef, type TdLevel, type TdPerk, Thing, Tower, type TowerBranchDef, type TowerDef, type TowerStats, type TowerTierDef, type TracedMap, type BusinessDef as TyBusinessDef, type EventDef as TyEventDef, type GoalDef as TyGoalDef, type LevelDef as TyLevelDef, Manager as TyManager, type SkillDef as TySkillDef, type UpgradeDef as TyUpgradeDef, type TycoonHeroDef, type TycoonLevel, UPGRADE_PICK, UPGRADE_PICKED, UPGRADE_REROLL, type UpgradeOption, type ViewSize, WAVE_STARTED, WEAPONS, WEAPON_IDS, WORLDS, WORLD_STARS, type WaveDef, type WaveGroup, type WeaponDef, type WeaponId, World, abilitiesFor, act, applyLink, artAspect, artDocument, attachRules, boardOf, buildFromVar, buildToVar, cellAt, cellCenter, chapterOf, checkEconomy, checkExpr, checkRules, compileExpr, cozyPack, createKitRegistry, createRegistry, defenseBoostsLink, defineKind, enemyOf$1 as enemyOf, evalNumber, fantasyPack, findMatches, fx, hasArt, hasErrors, hasMove, heroCharacterOf, heroUpgradeLink, laneRunnerBlock, levelOf$5 as levelOf, enemyOf as m3EnemyOf, levelOf$2 as m3LevelOf, skillOf$2 as m3SkillOf, m3StarsToEnter, match3Block, match3Preset, mergeBlock, mergePreset, metersOf, chainOf as mgChainOf, levelOf$1 as mgLevelOf, skillOf$1 as mgSkillOf, specialOf as mgSpecialOf, mgStarsFor, mgStarsToEnter, migrateSpec, mirrored, offerFromVar, offerToVar, packName, placeBackdrop, platformerBlock, levelOf$4 as platformerLevelOf, platformerPreset, postApocalypsePack, puzzleCityLink, registerCoreEffects, registerPlatformKit, resolveParams, roundBlock, runnerCollectionLink, runnerPreset, sciFiPack, scrollBackdrop, setPose, shortCash, specForPreset, starsToEnter, startMode, survivorsBlock, survivorsPreset, levelOf$3 as tdLevelOf, starsFor as tdStarsFor, tdStarsToEnter, wavesOf as tdWavesOf, towerArt, towerDefenseBlock, towerDefensePreset, towerOf, towerSpent, towerStats, traceMap, trackControls, botTimeOf as tyBotTimeOf, businessOf as tyBusinessOf, eventOf as tyEventOf, levelOf as tyLevelOf, skillOf as tySkillOf, tyStarsFor, tyStarsToEnter, tycoonBlock, tycoonPreset, tycoonStateOf, validateSpec, viewOf };
+/** Which part of the title a knob changes (the dashboard groups its cards by it). */
+type KnobGroup = "look" | "feel" | "economy" | "liveops" | "texts";
+/** When the decision model answers it: on creation (the one request that creates the title), on a later tune, or both. */
+type KnobStage = "create" | "tune";
+/** A text shown to the creator. English is required, other languages fall back to it. */
+type KnobText = Readonly<{
+    en: string;
+    ru?: string;
+} & Record<string, string | undefined>>;
+/**
+ * One change of one config section.
+ *
+ * `path` is a dot path inside the section; a segment `name[field=value]` picks the element of the
+ * array `name` whose `field` equals `value` (`modes[role=core].params.difficulty`); a key with a dot in
+ * it is quoted (`texts.'res.coins'.en`). Plain segments
+ * that are missing are created as objects; a missing array element is not created (the patch is
+ * skipped). An empty path is the section itself.
+ *
+ * The `GameSpec` section is a JSON string in the config: patches address the parsed object, the
+ * applier parses and serializes it.
+ */
+interface KnobPatch {
+    /** Config section: a property of the title's public configuration ("Look", "GameSpec", "Reward"…). */
+    readonly section: string;
+    /**
+     * set: put `value` (a level's value for a score knob); merge: deep-merge the object `value` (objects
+     * merge key by key, everything else is replaced); unset: remove; add / remove: put into / take out
+     * of the array at `path` each item of the array `value` (equal items once).
+     */
+    readonly op: "set" | "merge" | "unset" | "add" | "remove";
+    readonly path?: string;
+    readonly value?: unknown;
+    /**
+     * Score knobs only: the value from the answered level (0 = the first level, 1 = the last):
+     * `min + level × (max − min)`, rounded when `integer`, to `digits` places otherwise (default 2).
+     */
+    readonly range?: Readonly<{
+        min: number;
+        max: number;
+        integer?: boolean;
+        digits?: number;
+    }>;
+    /**
+     * Change only what the title already has: the patch is skipped when a key on its path (the last one
+     * too) is missing. Without it `set` / `merge` / `add` create the plain objects on the way, which is
+     * right for Look and GameSpec and wrong for content a seed brought (a quest, an event, a currency):
+     * a title without it would get a broken stub. The catalog sets it on every such section by itself.
+     */
+    readonly ifExists?: boolean;
+}
+/** An answer of a choice knob: what the decision model reads about it, what the creator sees, what it writes. */
+interface KnobOption {
+    /** Snake/kebab-case id, unique in its knob or list. */
+    readonly id: string;
+    readonly title: KnobText;
+    /** For the decision model: what this option is. */
+    readonly what: string;
+    /** For the decision model: what it is NOT for (keeps near options apart). */
+    readonly notFor?: string;
+    /** For the decision model: ideas it fits. */
+    readonly examples?: readonly string[];
+    /** Colour swatches or a preview hint for the dashboard card (#rrggbb). */
+    readonly swatch?: readonly string[];
+    readonly patches: readonly KnobPatch[];
+    /**
+     * Translations of the texts the patches write (`{ "ru": { "Gold": "Золото" } }`): the server puts them
+     * into the title's translation tables (only missing keys), like a seed's `$localization`.
+     */
+    readonly translations?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+}
+/** Which titles a knob is for. Omitted = every title. */
+interface KnobScope {
+    /** Any of these modules is in the title (a base or a system: "kit-game", "quests", "premium"). */
+    readonly modules?: readonly string[];
+    /** The title's constructor genre (the GameSpec core mode's preset): "runner", "tycoon"… */
+    readonly presets?: readonly string[];
+    /** Every one of these config sections has something in it (a knob of the daily calendar needs `Reward`). */
+    readonly sections?: readonly string[];
+}
+interface KnobBase {
+    /** Dotted id, unique in the catalog: "look.theme", "feel.runner.lanes". */
+    readonly id: string;
+    readonly group: KnobGroup;
+    readonly title: KnobText;
+    /** One line for the creator: what turning it changes. */
+    readonly hint?: KnobText;
+    readonly for?: KnobScope;
+    /** Omitted = both. */
+    readonly stages?: readonly KnobStage[];
+    /** The question for the decision model, in English. */
+    readonly question: string;
+}
+interface ChoiceKnob extends KnobBase {
+    readonly kind: "choice";
+    /** The options, or `list` (then the options are that list's items: a shared list, extendable in PlatformAdmin). */
+    readonly options?: readonly KnobOption[];
+    readonly list?: string;
+}
+interface ScoreKnob extends KnobBase {
+    readonly kind: "score";
+    /** 2..10 levels, from the first to the last; the decision model answers a fractional level. */
+    readonly levels: readonly string[];
+    /** What the creator sees on each level (short, per language), as many as `levels`: those are for the model. */
+    readonly levelTitles?: readonly KnobText[];
+    /** Applied with the answered level (their `range` gives the value). */
+    readonly patches: readonly KnobPatch[];
+}
+interface NoulKnob extends KnobBase {
+    readonly kind: "noul";
+    /** What "yes" and "no" mean, for the decision model. */
+    readonly yes: string;
+    readonly no: string;
+    readonly onYes: readonly KnobPatch[];
+    readonly onNo?: readonly KnobPatch[];
+}
+type KnobDef = ChoiceKnob | ScoreKnob | NoulKnob;
+/** The exported catalog: every knob, and the shared lists choice knobs point at. */
+interface KnobCatalog {
+    readonly version: number;
+    readonly knobs: readonly KnobDef[];
+    readonly lists: Readonly<Record<string, readonly KnobOption[]>>;
+}
+/** The decision model's limits (TypeSafe System One): options of a choice, levels of a score. */
+declare const DECISION_MAX_OPTIONS = 255;
+declare const DECISION_MAX_LEVELS = 10;
+
+/** One path segment: a key, or `key[field=value]` (an array element picked by a field). */
+interface Segment {
+    readonly key: string;
+    readonly match?: {
+        field: string;
+        value: string;
+    };
+}
+/** `modes[role=core].params.difficulty` → segments; `null` when a segment is malformed. */
+declare function parseKnobPath(path: string | undefined): Segment[] | null;
+/** A score answer (0..1) → the patch's value by its range; the patch's own value otherwise. */
+declare function patchValue(patch: KnobPatch, level?: number): unknown;
+/**
+ * Applies the patches in order to a section's value (a parsed object; `undefined` = the section is empty).
+ * Returns the new value and the indexes of the patches that could not be applied (a bad path, an array
+ * element that is not there, `add` to something that is not an array): they are skipped, the rest
+ * still applies. Never mutates the input.
+ */
+declare function applyPatches(section: unknown, patches: readonly KnobPatch[], level?: number): {
+    value: unknown;
+    skipped: number[];
+};
+/** Every (section, path) a list of patches writes: what a knob owns (pinning compares against it). */
+declare function patchTargets(patches: readonly KnobPatch[]): string[];
+
+declare const KNOB_CATALOG_VERSION = 1;
+declare const KNOBS: readonly KnobDef[];
+declare const KNOB_CATALOG: KnobCatalog;
+
+declare const UI_THEMES: readonly KnobOption[];
+declare const KIT_PALETTES: readonly KnobOption[];
+declare const HERO_LOOK_OPTIONS: readonly KnobOption[];
+declare const BACKGROUND_OPTIONS: readonly KnobOption[];
+declare const SOUND_SET_OPTIONS: readonly KnobOption[];
+/** Ids the UI kit must know how to draw / play (its own tests check them against these lists). */
+declare const LOOK_RUNTIME_IDS: {
+    readonly backgrounds: string[];
+    readonly soundSets: string[];
+};
+/** All shared lists by id. */
+declare const KNOB_LISTS: Readonly<Record<string, readonly KnobOption[]>>;
+
+/** Errors of a catalog; empty = good. */
+declare function validateKnobCatalog(catalog: KnobCatalog): string[];
+
+export { ABILITIES, ART, ASSET_PACKS, type AbilityId, ActorAct, ActorPose, type ArtContext, type ArtDef, ArtLook, type AssetPackDef, BACKGROUND_OPTIONS, BLOCKS, BOSS_DEFEATED, BOSS_SPAWNED, BRANCH_LEVEL, type BlockContext, type BlockDef, type Board, Body, Bullet, CHAPTERS, CORE_EFFECTS, CastDef, type ChoiceKnob, ComponentType, type Controls, DECISION_MAX_LEVELS, DECISION_MAX_OPTIONS, DEFAULT_REWARDS, DEMO_SPEC, type DamageType, type DefineOptions, Drop, EFFECTS, ENEMIES$1 as ENEMIES, ENGINES, ENTRY_ID_RE, type EffectContext, type EffectDef, type EffectSpec, type EnemyDef$1 as EnemyDef, type Engine, Entity, type Expr, ExprError, type ExprScope, type ExprValue, FOES, FUNCTIONS, type FlowSpec, Foe, type FoeKind, FxEvent, GIVE_UP, type GameSpec, Gem, HEROES, HERO_LOOK_OPTIONS, type HeroDef, type Issue, Jumper, KIT_PALETTES, KNOBS, KNOB_CATALOG, KNOB_CATALOG_VERSION, KNOB_LISTS, KNOWN_SYSTEMS, type KindGrid, type KnobCatalog, type KnobDef, type KnobGroup, type KnobOption, type KnobPatch, type KnobScope, type KnobStage, type KnobText, LEVELS_PER_WORLD, LEVEL_CLEARED, LEVEL_MAPS, LEVEL_UP, LINKS, LOOK_RUNTIME_IDS, type LinkDef, type EnemyDef as M3EnemyDef, type GoalDef$1 as M3GoalDef, type M3HeroDef, type M3Level, type LevelDef$2 as M3LevelDef, type SkillDef$2 as M3SkillDef, M3_CHARACTER, ELEMENTS as M3_ELEMENTS, ENEMIES as M3_ENEMIES, M3_HEROES, M3_LEVELS, M3_LEVELS_PER_WORLD, LEVELS$2 as M3_LEVEL_DEFS, M3_META, M3_META_STATS, OBSTACLES$1 as M3_OBSTACLES, PIECES as M3_PIECES, SKILLS$2 as M3_SKILLS, SPECIALS as M3_SPECIALS, M3_WORLDS, M3_WORLD_STARS, MAPS, MAP_COLS, MAP_ROWS, MAX_LEVEL, MAX_PASSIVES, MAX_WEAPONS, META_CHARACTER, META_STATS, BOARDS as MG_BOARDS, CHAINS as MG_CHAINS, MG_CHARACTER, MG_COLS, MG_HEROES, MG_LEVELS, MG_LEVELS_PER_WORLD, LEVELS$1 as MG_LEVEL_DEFS, MG_META, MG_META_STATS, OBSTACLES as MG_OBSTACLES, MG_REVIVE_ENERGY, MG_ROWS, SKILLS$1 as MG_SKILLS, SPECIAL_ITEMS as MG_SPECIAL_ITEMS, MG_WORLDS, MG_WORLD_STARS, type MapDef, type MergeHeroDef, MergeItem, type MergeLevel, type MetaGameDef, type MetaHeroDef, type MetaStatDef, type ChainDef as MgChainDef, type LevelDef$1 as MgLevelDef, type ObstacleDef as MgObstacleDef, type OrderDef as MgOrderDef, type SkillDef$1 as MgSkillDef, type SpecialItemDef as MgSpecialItemDef, type WantDef as MgWantDef, Missile, type ModeSpec, type NoulKnob, type NumberOrFormula, OBSTACLE_KINDS, type ObstacleKind, Order, PASSIVES, PASSIVE_IDS, PIECE_COLORS, PLATFORMER_CHARACTER, PLATFORMER_HEROES, PLATFORMER_LEVELS, PLATFORMER_META, PLATFORMER_META_STATS, PLATFORM_LINKS, PLATFORM_PACKS, PLATFORM_PRESETS, POWERS, POWER_IDS, PRESETS, type ParamDef, type ParamDefs, type ParamValue, type PassiveDef, type PassiveId, type PlatformerHeroDef, type PlatformerLevel, type PlatformerPerk, type PowerDef, type PowerId, type PresetDef, REROLL_GEMS, REVIVE, REVIVE_GEMS, REVIVE_OFFER, ROOMS, ROOM_ROWS, ROUND_ENDED, ROUND_OVER, ROUND_STARTED, RUNNER_CHARACTER, RUNNER_HEROES, RUNNER_LEVELS, RUNNER_META, RUNNER_META_STATS, Raider, type Registry, type RegistryEntry, type RegistryKind, type ResolvedMode, type ResolvedSpec, type ResourceSpec, type RewardedPlacementDef, type RewardsSpec, RoadItem, type RoomDef, type RoomFeature, type RoundState, type RuleDef, Runner, type RunnerHeroDef, type RunnerLevel, type RunnerPerk, type RunningMode, SELL_SHARE, SHOW_START, SOUND_SET_OPTIONS, SPEC_VERSION, SPELLS, START_ROUND, SURVIVORS_META, type ScoreKnob, Shot, Soldier, type SpecResult, type SpellDef, Spot, type StartModeOptions, Survivor, type SurvivorsBuild, TD_CHARACTER, TD_HEROES, TD_LEVELS, TD_LEVELS_PER_WORLD, TD_LIVES, TD_META, TD_META_STATS, REVIVE_LIVES as TD_REVIVE_LIVES, TD_WORLDS, TD_WORLD_STARS, TOWERS, BUSINESSES as TY_BUSINESSES, TY_CHARACTER, EVENTS as TY_EVENTS, TY_HEROES, TY_LEVELS, TY_LEVELS_PER_WORLD, LEVELS as TY_LEVEL_DEFS, TY_META, TY_META_STATS, MILESTONES as TY_MILESTONES, TY_REVIVE_SECONDS, SKILLS as TY_SKILLS, UPGRADES as TY_UPGRADES, TY_WORLDS, TY_WORLD_STARS, type TdHeroDef, type TdLevel, type TdPerk, Thing, Tower, type TowerBranchDef, type TowerDef, type TowerStats, type TowerTierDef, type TracedMap, type BusinessDef as TyBusinessDef, type EventDef as TyEventDef, type GoalDef as TyGoalDef, type LevelDef as TyLevelDef, Manager as TyManager, type SkillDef as TySkillDef, type UpgradeDef as TyUpgradeDef, type TycoonHeroDef, type TycoonLevel, UI_THEMES, UPGRADE_PICK, UPGRADE_PICKED, UPGRADE_REROLL, type UpgradeOption, type ViewSize, WAVE_STARTED, WEAPONS, WEAPON_IDS, WORLDS, WORLD_STARS, type WaveDef, type WaveGroup, type WeaponDef, type WeaponId, World, abilitiesFor, act, applyLink, applyPatches, artAspect, artDocument, attachRules, boardOf, buildFromVar, buildToVar, cellAt, cellCenter, chapterOf, checkEconomy, checkExpr, checkRules, compileExpr, contentOf, cozyPack, createKitRegistry, createRegistry, defenseBoostsLink, defineKind, enemyOf$1 as enemyOf, evalNumber, fantasyPack, findMatches, fx, hasArt, hasErrors, hasMove, heroCharacterOf, heroUpgradeLink, laneRunnerBlock, levelOf$5 as levelOf, enemyOf as m3EnemyOf, levelOf$2 as m3LevelOf, skillOf$2 as m3SkillOf, m3StarsToEnter, match3Block, match3Preset, mergeBlock, mergePreset, metersOf, chainOf as mgChainOf, levelOf$1 as mgLevelOf, skillOf$1 as mgSkillOf, specialOf as mgSpecialOf, mgStarsFor, mgStarsToEnter, migrateSpec, mirrored, offerFromVar, offerToVar, packName, parseKnobPath, patchTargets, patchValue, placeBackdrop, platformerBlock, levelOf$4 as platformerLevelOf, platformerPreset, postApocalypsePack, puzzleCityLink, registerCoreEffects, registerPlatformKit, resolveParams, roundBlock, runnerCollectionLink, runnerPreset, sciFiPack, scrollBackdrop, setPose, shortCash, specForPreset, starsToEnter, startMode, survivorsBlock, survivorsPreset, levelOf$3 as tdLevelOf, starsFor as tdStarsFor, tdStarsToEnter, wavesOf as tdWavesOf, towerArt, towerDefenseBlock, towerDefensePreset, towerOf, towerSpent, towerStats, traceMap, trackControls, botTimeOf as tyBotTimeOf, businessOf as tyBusinessOf, eventOf as tyEventOf, levelOf as tyLevelOf, skillOf as tySkillOf, tyStarsFor, tyStarsToEnter, tycoonBlock, tycoonPreset, tycoonStateOf, validateKnobCatalog, validateSpec, viewOf };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { W as World, A as ArtLook, E as Entity, a as ActorAct, F as FxEvent, b as ActorPose, c as ComponentType, C as CastDef } from './view-CS-ixOId.js';
+import { W as World, C as CastDef, A as ArtLook, E as Entity, a as ActorAct, F as FxEvent, b as ActorPose, c as ComponentType } from './view-CS-ixOId.js';
 export { D as DEFAULT_CAST, d as DEFAULT_LOOK, e as DEFAULT_PALETTE, f as EventHandler, g as FX_TOPIC, I as INPUT_TOPIC, h as InputEvent, R as Rng, S as System, i as Transform, T as TransformData, j as VIEW_RESIZED_TOPIC, k as Visual, V as VisualData, l as WorldOptions, m as WorldVar, n as createFixedStepper, o as createRng, p as defineComponent, q as mergePalette, r as resolveColor } from './view-CS-ixOId.js';
 
 /** Every entry has a stable id and a version (bumped on an incompatible change of the entry). */
@@ -181,6 +181,14 @@ interface ModeSpec {
     readonly blockParams?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
     /** Rules of this mode, after the preset's own. */
     readonly rules?: readonly RuleDef[];
+    /**
+     * Which rows of the genre's own lists this game leaves out (tuning knobs, 08.11.2026): `{ "powers":
+     * { "without": ["flight"] } }`. The kinds are the genre's (runner: powers, obstacles; survivors:
+     * foes). A block never ends up with nothing: leaving out every row of a kind keeps them all.
+     */
+    readonly content?: Readonly<Record<string, Readonly<{
+        without?: readonly string[];
+    }>>>;
 }
 interface ResourceSpec {
     /** Snake-case id, readable in formulas as `res.<id>`. */
@@ -233,6 +241,8 @@ interface GameSpec {
     readonly palette?: Readonly<Record<string, string>>;
     /** Text key → language → text: `{ "title": { "en": "Lava Run", "ru": "Лавовый забег" } }`. */
     readonly texts?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** Who the actors are, over the asset pack's cast, role by role: `{ "hero": { "preset": "viking", "races": ["dwarf"] } }`. */
+    readonly cast?: Readonly<Record<string, Partial<CastDef>>>;
     readonly rewards?: RewardsSpec;
     readonly multiplayer?: "none" | "async" | "coop" | "pvp";
     /** Unknown fields are kept. */
@@ -247,7 +257,14 @@ interface ResolvedMode {
     readonly blockParams: Readonly<Record<string, Readonly<Record<string, ParamValue>>>>;
     /** Preset rules, then the mode's own. */
     readonly rules: readonly RuleDef[];
+    /** Kind → the row ids this game leaves out (see ModeSpec.content); read through `contentOf`. */
+    readonly content: Readonly<Record<string, readonly string[]>>;
 }
+/**
+ * The rows of a genre list this mode plays with: `all` without the ones the spec leaves out. Never
+ * empty: a spec that leaves out every row keeps them all (a game must stay playable).
+ */
+declare function contentOf<T extends string>(mode: Pick<ResolvedMode, "content"> | undefined, kind: string, all: readonly T[]): readonly T[];
 interface ResolvedSpec {
     readonly spec: GameSpec;
     readonly engine: Engine;
@@ -318,7 +335,7 @@ interface PresetDef extends RegistryEntry {
     readonly name?: string;
     /** Block ids in setup order. */
     readonly blocks: readonly string[];
-    /** The preset's own parameters (what Jev's Score questions and the config agent set). */
+    /** The preset's own parameters (what the decision model's score questions and the config agent set). */
     readonly params?: ParamDefs;
     /**
      * Values the preset gives its blocks' parameters: `{ "waves": { "count": 10 } }`. For a number or
@@ -1137,9 +1154,12 @@ interface TdLevel {
     readonly enemies: readonly string[];
     readonly firstClearGold: number;
 }
-/** The waves of a level: a budget a wave, spent on the foes open by then; the new foe shows itself early. */
-declare function wavesOf(level: number, entries: number): WaveDef[];
-declare function levelOf$3(level: number, difficulty?: number): TdLevel;
+/**
+ * The waves of a level: a budget a wave, spent on the foes open by then; the new foe shows itself early.
+ * `foes`: the wave foes this game plays with (GameSpec content), every one when omitted.
+ */
+declare function wavesOf(level: number, entries: number, foes?: readonly string[]): WaveDef[];
+declare function levelOf$3(level: number, difficulty?: number, foes?: readonly string[]): TdLevel;
 /** Stars needed to play a level (its world's gate). */
 declare const tdStarsToEnter: (level: number) => number;
 /** The stars a cleared level gives by the lives kept: all of them nearly — three. */
@@ -1838,4 +1858,175 @@ declare function specForPreset(presetId: string, options?: {
     coinRef?: string;
 }): GameSpec;
 
-export { ABILITIES, ART, ASSET_PACKS, type AbilityId, ActorAct, ActorPose, type ArtContext, type ArtDef, ArtLook, type AssetPackDef, BLOCKS, BOSS_DEFEATED, BOSS_SPAWNED, BRANCH_LEVEL, type BlockContext, type BlockDef, type Board, Body, Bullet, CHAPTERS, CORE_EFFECTS, CastDef, ComponentType, type Controls, DEFAULT_REWARDS, DEMO_SPEC, type DamageType, type DefineOptions, Drop, EFFECTS, ENEMIES$1 as ENEMIES, ENGINES, ENTRY_ID_RE, type EffectContext, type EffectDef, type EffectSpec, type EnemyDef$1 as EnemyDef, type Engine, Entity, type Expr, ExprError, type ExprScope, type ExprValue, FOES, FUNCTIONS, type FlowSpec, Foe, type FoeKind, FxEvent, GIVE_UP, type GameSpec, Gem, HEROES, type HeroDef, type Issue, Jumper, KNOWN_SYSTEMS, type KindGrid, LEVELS_PER_WORLD, LEVEL_CLEARED, LEVEL_MAPS, LEVEL_UP, LINKS, type LinkDef, type EnemyDef as M3EnemyDef, type GoalDef$1 as M3GoalDef, type M3HeroDef, type M3Level, type LevelDef$2 as M3LevelDef, type SkillDef$2 as M3SkillDef, M3_CHARACTER, ELEMENTS as M3_ELEMENTS, ENEMIES as M3_ENEMIES, M3_HEROES, M3_LEVELS, M3_LEVELS_PER_WORLD, LEVELS$2 as M3_LEVEL_DEFS, M3_META, M3_META_STATS, OBSTACLES$1 as M3_OBSTACLES, PIECES as M3_PIECES, SKILLS$2 as M3_SKILLS, SPECIALS as M3_SPECIALS, M3_WORLDS, M3_WORLD_STARS, MAPS, MAP_COLS, MAP_ROWS, MAX_LEVEL, MAX_PASSIVES, MAX_WEAPONS, META_CHARACTER, META_STATS, BOARDS as MG_BOARDS, CHAINS as MG_CHAINS, MG_CHARACTER, MG_COLS, MG_HEROES, MG_LEVELS, MG_LEVELS_PER_WORLD, LEVELS$1 as MG_LEVEL_DEFS, MG_META, MG_META_STATS, OBSTACLES as MG_OBSTACLES, MG_REVIVE_ENERGY, MG_ROWS, SKILLS$1 as MG_SKILLS, SPECIAL_ITEMS as MG_SPECIAL_ITEMS, MG_WORLDS, MG_WORLD_STARS, type MapDef, type MergeHeroDef, MergeItem, type MergeLevel, type MetaGameDef, type MetaHeroDef, type MetaStatDef, type ChainDef as MgChainDef, type LevelDef$1 as MgLevelDef, type ObstacleDef as MgObstacleDef, type OrderDef as MgOrderDef, type SkillDef$1 as MgSkillDef, type SpecialItemDef as MgSpecialItemDef, type WantDef as MgWantDef, Missile, type ModeSpec, type NumberOrFormula, OBSTACLE_KINDS, type ObstacleKind, Order, PASSIVES, PASSIVE_IDS, PIECE_COLORS, PLATFORMER_CHARACTER, PLATFORMER_HEROES, PLATFORMER_LEVELS, PLATFORMER_META, PLATFORMER_META_STATS, PLATFORM_LINKS, PLATFORM_PACKS, PLATFORM_PRESETS, POWERS, POWER_IDS, PRESETS, type ParamDef, type ParamDefs, type ParamValue, type PassiveDef, type PassiveId, type PlatformerHeroDef, type PlatformerLevel, type PlatformerPerk, type PowerDef, type PowerId, type PresetDef, REROLL_GEMS, REVIVE, REVIVE_GEMS, REVIVE_OFFER, ROOMS, ROOM_ROWS, ROUND_ENDED, ROUND_OVER, ROUND_STARTED, RUNNER_CHARACTER, RUNNER_HEROES, RUNNER_LEVELS, RUNNER_META, RUNNER_META_STATS, Raider, type Registry, type RegistryEntry, type RegistryKind, type ResolvedMode, type ResolvedSpec, type ResourceSpec, type RewardedPlacementDef, type RewardsSpec, RoadItem, type RoomDef, type RoomFeature, type RoundState, type RuleDef, Runner, type RunnerHeroDef, type RunnerLevel, type RunnerPerk, type RunningMode, SELL_SHARE, SHOW_START, SPEC_VERSION, SPELLS, START_ROUND, SURVIVORS_META, Shot, Soldier, type SpecResult, type SpellDef, Spot, type StartModeOptions, Survivor, type SurvivorsBuild, TD_CHARACTER, TD_HEROES, TD_LEVELS, TD_LEVELS_PER_WORLD, TD_LIVES, TD_META, TD_META_STATS, REVIVE_LIVES as TD_REVIVE_LIVES, TD_WORLDS, TD_WORLD_STARS, TOWERS, BUSINESSES as TY_BUSINESSES, TY_CHARACTER, EVENTS as TY_EVENTS, TY_HEROES, TY_LEVELS, TY_LEVELS_PER_WORLD, LEVELS as TY_LEVEL_DEFS, TY_META, TY_META_STATS, MILESTONES as TY_MILESTONES, TY_REVIVE_SECONDS, SKILLS as TY_SKILLS, UPGRADES as TY_UPGRADES, TY_WORLDS, TY_WORLD_STARS, type TdHeroDef, type TdLevel, type TdPerk, Thing, Tower, type TowerBranchDef, type TowerDef, type TowerStats, type TowerTierDef, type TracedMap, type BusinessDef as TyBusinessDef, type EventDef as TyEventDef, type GoalDef as TyGoalDef, type LevelDef as TyLevelDef, Manager as TyManager, type SkillDef as TySkillDef, type UpgradeDef as TyUpgradeDef, type TycoonHeroDef, type TycoonLevel, UPGRADE_PICK, UPGRADE_PICKED, UPGRADE_REROLL, type UpgradeOption, type ViewSize, WAVE_STARTED, WEAPONS, WEAPON_IDS, WORLDS, WORLD_STARS, type WaveDef, type WaveGroup, type WeaponDef, type WeaponId, World, abilitiesFor, act, applyLink, artAspect, artDocument, attachRules, boardOf, buildFromVar, buildToVar, cellAt, cellCenter, chapterOf, checkEconomy, checkExpr, checkRules, compileExpr, cozyPack, createKitRegistry, createRegistry, defenseBoostsLink, defineKind, enemyOf$1 as enemyOf, evalNumber, fantasyPack, findMatches, fx, hasArt, hasErrors, hasMove, heroCharacterOf, heroUpgradeLink, laneRunnerBlock, levelOf$5 as levelOf, enemyOf as m3EnemyOf, levelOf$2 as m3LevelOf, skillOf$2 as m3SkillOf, m3StarsToEnter, match3Block, match3Preset, mergeBlock, mergePreset, metersOf, chainOf as mgChainOf, levelOf$1 as mgLevelOf, skillOf$1 as mgSkillOf, specialOf as mgSpecialOf, mgStarsFor, mgStarsToEnter, migrateSpec, mirrored, offerFromVar, offerToVar, packName, placeBackdrop, platformerBlock, levelOf$4 as platformerLevelOf, platformerPreset, postApocalypsePack, puzzleCityLink, registerCoreEffects, registerPlatformKit, resolveParams, roundBlock, runnerCollectionLink, runnerPreset, sciFiPack, scrollBackdrop, setPose, shortCash, specForPreset, starsToEnter, startMode, survivorsBlock, survivorsPreset, levelOf$3 as tdLevelOf, starsFor as tdStarsFor, tdStarsToEnter, wavesOf as tdWavesOf, towerArt, towerDefenseBlock, towerDefensePreset, towerOf, towerSpent, towerStats, traceMap, trackControls, botTimeOf as tyBotTimeOf, businessOf as tyBusinessOf, eventOf as tyEventOf, levelOf as tyLevelOf, skillOf as tySkillOf, tyStarsFor, tyStarsToEnter, tycoonBlock, tycoonPreset, tycoonStateOf, validateSpec, viewOf };
+/** Which part of the title a knob changes (the dashboard groups its cards by it). */
+type KnobGroup = "look" | "feel" | "economy" | "liveops" | "texts";
+/** When the decision model answers it: on creation (the one request that creates the title), on a later tune, or both. */
+type KnobStage = "create" | "tune";
+/** A text shown to the creator. English is required, other languages fall back to it. */
+type KnobText = Readonly<{
+    en: string;
+    ru?: string;
+} & Record<string, string | undefined>>;
+/**
+ * One change of one config section.
+ *
+ * `path` is a dot path inside the section; a segment `name[field=value]` picks the element of the
+ * array `name` whose `field` equals `value` (`modes[role=core].params.difficulty`); a key with a dot in
+ * it is quoted (`texts.'res.coins'.en`). Plain segments
+ * that are missing are created as objects; a missing array element is not created (the patch is
+ * skipped). An empty path is the section itself.
+ *
+ * The `GameSpec` section is a JSON string in the config: patches address the parsed object, the
+ * applier parses and serializes it.
+ */
+interface KnobPatch {
+    /** Config section: a property of the title's public configuration ("Look", "GameSpec", "Reward"…). */
+    readonly section: string;
+    /**
+     * set: put `value` (a level's value for a score knob); merge: deep-merge the object `value` (objects
+     * merge key by key, everything else is replaced); unset: remove; add / remove: put into / take out
+     * of the array at `path` each item of the array `value` (equal items once).
+     */
+    readonly op: "set" | "merge" | "unset" | "add" | "remove";
+    readonly path?: string;
+    readonly value?: unknown;
+    /**
+     * Score knobs only: the value from the answered level (0 = the first level, 1 = the last):
+     * `min + level × (max − min)`, rounded when `integer`, to `digits` places otherwise (default 2).
+     */
+    readonly range?: Readonly<{
+        min: number;
+        max: number;
+        integer?: boolean;
+        digits?: number;
+    }>;
+    /**
+     * Change only what the title already has: the patch is skipped when a key on its path (the last one
+     * too) is missing. Without it `set` / `merge` / `add` create the plain objects on the way, which is
+     * right for Look and GameSpec and wrong for content a seed brought (a quest, an event, a currency):
+     * a title without it would get a broken stub. The catalog sets it on every such section by itself.
+     */
+    readonly ifExists?: boolean;
+}
+/** An answer of a choice knob: what the decision model reads about it, what the creator sees, what it writes. */
+interface KnobOption {
+    /** Snake/kebab-case id, unique in its knob or list. */
+    readonly id: string;
+    readonly title: KnobText;
+    /** For the decision model: what this option is. */
+    readonly what: string;
+    /** For the decision model: what it is NOT for (keeps near options apart). */
+    readonly notFor?: string;
+    /** For the decision model: ideas it fits. */
+    readonly examples?: readonly string[];
+    /** Colour swatches or a preview hint for the dashboard card (#rrggbb). */
+    readonly swatch?: readonly string[];
+    readonly patches: readonly KnobPatch[];
+    /**
+     * Translations of the texts the patches write (`{ "ru": { "Gold": "Золото" } }`): the server puts them
+     * into the title's translation tables (only missing keys), like a seed's `$localization`.
+     */
+    readonly translations?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+}
+/** Which titles a knob is for. Omitted = every title. */
+interface KnobScope {
+    /** Any of these modules is in the title (a base or a system: "kit-game", "quests", "premium"). */
+    readonly modules?: readonly string[];
+    /** The title's constructor genre (the GameSpec core mode's preset): "runner", "tycoon"… */
+    readonly presets?: readonly string[];
+    /** Every one of these config sections has something in it (a knob of the daily calendar needs `Reward`). */
+    readonly sections?: readonly string[];
+}
+interface KnobBase {
+    /** Dotted id, unique in the catalog: "look.theme", "feel.runner.lanes". */
+    readonly id: string;
+    readonly group: KnobGroup;
+    readonly title: KnobText;
+    /** One line for the creator: what turning it changes. */
+    readonly hint?: KnobText;
+    readonly for?: KnobScope;
+    /** Omitted = both. */
+    readonly stages?: readonly KnobStage[];
+    /** The question for the decision model, in English. */
+    readonly question: string;
+}
+interface ChoiceKnob extends KnobBase {
+    readonly kind: "choice";
+    /** The options, or `list` (then the options are that list's items: a shared list, extendable in PlatformAdmin). */
+    readonly options?: readonly KnobOption[];
+    readonly list?: string;
+}
+interface ScoreKnob extends KnobBase {
+    readonly kind: "score";
+    /** 2..10 levels, from the first to the last; the decision model answers a fractional level. */
+    readonly levels: readonly string[];
+    /** What the creator sees on each level (short, per language), as many as `levels`: those are for the model. */
+    readonly levelTitles?: readonly KnobText[];
+    /** Applied with the answered level (their `range` gives the value). */
+    readonly patches: readonly KnobPatch[];
+}
+interface NoulKnob extends KnobBase {
+    readonly kind: "noul";
+    /** What "yes" and "no" mean, for the decision model. */
+    readonly yes: string;
+    readonly no: string;
+    readonly onYes: readonly KnobPatch[];
+    readonly onNo?: readonly KnobPatch[];
+}
+type KnobDef = ChoiceKnob | ScoreKnob | NoulKnob;
+/** The exported catalog: every knob, and the shared lists choice knobs point at. */
+interface KnobCatalog {
+    readonly version: number;
+    readonly knobs: readonly KnobDef[];
+    readonly lists: Readonly<Record<string, readonly KnobOption[]>>;
+}
+/** The decision model's limits (TypeSafe System One): options of a choice, levels of a score. */
+declare const DECISION_MAX_OPTIONS = 255;
+declare const DECISION_MAX_LEVELS = 10;
+
+/** One path segment: a key, or `key[field=value]` (an array element picked by a field). */
+interface Segment {
+    readonly key: string;
+    readonly match?: {
+        field: string;
+        value: string;
+    };
+}
+/** `modes[role=core].params.difficulty` → segments; `null` when a segment is malformed. */
+declare function parseKnobPath(path: string | undefined): Segment[] | null;
+/** A score answer (0..1) → the patch's value by its range; the patch's own value otherwise. */
+declare function patchValue(patch: KnobPatch, level?: number): unknown;
+/**
+ * Applies the patches in order to a section's value (a parsed object; `undefined` = the section is empty).
+ * Returns the new value and the indexes of the patches that could not be applied (a bad path, an array
+ * element that is not there, `add` to something that is not an array): they are skipped, the rest
+ * still applies. Never mutates the input.
+ */
+declare function applyPatches(section: unknown, patches: readonly KnobPatch[], level?: number): {
+    value: unknown;
+    skipped: number[];
+};
+/** Every (section, path) a list of patches writes: what a knob owns (pinning compares against it). */
+declare function patchTargets(patches: readonly KnobPatch[]): string[];
+
+declare const KNOB_CATALOG_VERSION = 1;
+declare const KNOBS: readonly KnobDef[];
+declare const KNOB_CATALOG: KnobCatalog;
+
+declare const UI_THEMES: readonly KnobOption[];
+declare const KIT_PALETTES: readonly KnobOption[];
+declare const HERO_LOOK_OPTIONS: readonly KnobOption[];
+declare const BACKGROUND_OPTIONS: readonly KnobOption[];
+declare const SOUND_SET_OPTIONS: readonly KnobOption[];
+/** Ids the UI kit must know how to draw / play (its own tests check them against these lists). */
+declare const LOOK_RUNTIME_IDS: {
+    readonly backgrounds: string[];
+    readonly soundSets: string[];
+};
+/** All shared lists by id. */
+declare const KNOB_LISTS: Readonly<Record<string, readonly KnobOption[]>>;
+
+/** Errors of a catalog; empty = good. */
+declare function validateKnobCatalog(catalog: KnobCatalog): string[];
+
+export { ABILITIES, ART, ASSET_PACKS, type AbilityId, ActorAct, ActorPose, type ArtContext, type ArtDef, ArtLook, type AssetPackDef, BACKGROUND_OPTIONS, BLOCKS, BOSS_DEFEATED, BOSS_SPAWNED, BRANCH_LEVEL, type BlockContext, type BlockDef, type Board, Body, Bullet, CHAPTERS, CORE_EFFECTS, CastDef, type ChoiceKnob, ComponentType, type Controls, DECISION_MAX_LEVELS, DECISION_MAX_OPTIONS, DEFAULT_REWARDS, DEMO_SPEC, type DamageType, type DefineOptions, Drop, EFFECTS, ENEMIES$1 as ENEMIES, ENGINES, ENTRY_ID_RE, type EffectContext, type EffectDef, type EffectSpec, type EnemyDef$1 as EnemyDef, type Engine, Entity, type Expr, ExprError, type ExprScope, type ExprValue, FOES, FUNCTIONS, type FlowSpec, Foe, type FoeKind, FxEvent, GIVE_UP, type GameSpec, Gem, HEROES, HERO_LOOK_OPTIONS, type HeroDef, type Issue, Jumper, KIT_PALETTES, KNOBS, KNOB_CATALOG, KNOB_CATALOG_VERSION, KNOB_LISTS, KNOWN_SYSTEMS, type KindGrid, type KnobCatalog, type KnobDef, type KnobGroup, type KnobOption, type KnobPatch, type KnobScope, type KnobStage, type KnobText, LEVELS_PER_WORLD, LEVEL_CLEARED, LEVEL_MAPS, LEVEL_UP, LINKS, LOOK_RUNTIME_IDS, type LinkDef, type EnemyDef as M3EnemyDef, type GoalDef$1 as M3GoalDef, type M3HeroDef, type M3Level, type LevelDef$2 as M3LevelDef, type SkillDef$2 as M3SkillDef, M3_CHARACTER, ELEMENTS as M3_ELEMENTS, ENEMIES as M3_ENEMIES, M3_HEROES, M3_LEVELS, M3_LEVELS_PER_WORLD, LEVELS$2 as M3_LEVEL_DEFS, M3_META, M3_META_STATS, OBSTACLES$1 as M3_OBSTACLES, PIECES as M3_PIECES, SKILLS$2 as M3_SKILLS, SPECIALS as M3_SPECIALS, M3_WORLDS, M3_WORLD_STARS, MAPS, MAP_COLS, MAP_ROWS, MAX_LEVEL, MAX_PASSIVES, MAX_WEAPONS, META_CHARACTER, META_STATS, BOARDS as MG_BOARDS, CHAINS as MG_CHAINS, MG_CHARACTER, MG_COLS, MG_HEROES, MG_LEVELS, MG_LEVELS_PER_WORLD, LEVELS$1 as MG_LEVEL_DEFS, MG_META, MG_META_STATS, OBSTACLES as MG_OBSTACLES, MG_REVIVE_ENERGY, MG_ROWS, SKILLS$1 as MG_SKILLS, SPECIAL_ITEMS as MG_SPECIAL_ITEMS, MG_WORLDS, MG_WORLD_STARS, type MapDef, type MergeHeroDef, MergeItem, type MergeLevel, type MetaGameDef, type MetaHeroDef, type MetaStatDef, type ChainDef as MgChainDef, type LevelDef$1 as MgLevelDef, type ObstacleDef as MgObstacleDef, type OrderDef as MgOrderDef, type SkillDef$1 as MgSkillDef, type SpecialItemDef as MgSpecialItemDef, type WantDef as MgWantDef, Missile, type ModeSpec, type NoulKnob, type NumberOrFormula, OBSTACLE_KINDS, type ObstacleKind, Order, PASSIVES, PASSIVE_IDS, PIECE_COLORS, PLATFORMER_CHARACTER, PLATFORMER_HEROES, PLATFORMER_LEVELS, PLATFORMER_META, PLATFORMER_META_STATS, PLATFORM_LINKS, PLATFORM_PACKS, PLATFORM_PRESETS, POWERS, POWER_IDS, PRESETS, type ParamDef, type ParamDefs, type ParamValue, type PassiveDef, type PassiveId, type PlatformerHeroDef, type PlatformerLevel, type PlatformerPerk, type PowerDef, type PowerId, type PresetDef, REROLL_GEMS, REVIVE, REVIVE_GEMS, REVIVE_OFFER, ROOMS, ROOM_ROWS, ROUND_ENDED, ROUND_OVER, ROUND_STARTED, RUNNER_CHARACTER, RUNNER_HEROES, RUNNER_LEVELS, RUNNER_META, RUNNER_META_STATS, Raider, type Registry, type RegistryEntry, type RegistryKind, type ResolvedMode, type ResolvedSpec, type ResourceSpec, type RewardedPlacementDef, type RewardsSpec, RoadItem, type RoomDef, type RoomFeature, type RoundState, type RuleDef, Runner, type RunnerHeroDef, type RunnerLevel, type RunnerPerk, type RunningMode, SELL_SHARE, SHOW_START, SOUND_SET_OPTIONS, SPEC_VERSION, SPELLS, START_ROUND, SURVIVORS_META, type ScoreKnob, Shot, Soldier, type SpecResult, type SpellDef, Spot, type StartModeOptions, Survivor, type SurvivorsBuild, TD_CHARACTER, TD_HEROES, TD_LEVELS, TD_LEVELS_PER_WORLD, TD_LIVES, TD_META, TD_META_STATS, REVIVE_LIVES as TD_REVIVE_LIVES, TD_WORLDS, TD_WORLD_STARS, TOWERS, BUSINESSES as TY_BUSINESSES, TY_CHARACTER, EVENTS as TY_EVENTS, TY_HEROES, TY_LEVELS, TY_LEVELS_PER_WORLD, LEVELS as TY_LEVEL_DEFS, TY_META, TY_META_STATS, MILESTONES as TY_MILESTONES, TY_REVIVE_SECONDS, SKILLS as TY_SKILLS, UPGRADES as TY_UPGRADES, TY_WORLDS, TY_WORLD_STARS, type TdHeroDef, type TdLevel, type TdPerk, Thing, Tower, type TowerBranchDef, type TowerDef, type TowerStats, type TowerTierDef, type TracedMap, type BusinessDef as TyBusinessDef, type EventDef as TyEventDef, type GoalDef as TyGoalDef, type LevelDef as TyLevelDef, Manager as TyManager, type SkillDef as TySkillDef, type UpgradeDef as TyUpgradeDef, type TycoonHeroDef, type TycoonLevel, UI_THEMES, UPGRADE_PICK, UPGRADE_PICKED, UPGRADE_REROLL, type UpgradeOption, type ViewSize, WAVE_STARTED, WEAPONS, WEAPON_IDS, WORLDS, WORLD_STARS, type WaveDef, type WaveGroup, type WeaponDef, type WeaponId, World, abilitiesFor, act, applyLink, applyPatches, artAspect, artDocument, attachRules, boardOf, buildFromVar, buildToVar, cellAt, cellCenter, chapterOf, checkEconomy, checkExpr, checkRules, compileExpr, contentOf, cozyPack, createKitRegistry, createRegistry, defenseBoostsLink, defineKind, enemyOf$1 as enemyOf, evalNumber, fantasyPack, findMatches, fx, hasArt, hasErrors, hasMove, heroCharacterOf, heroUpgradeLink, laneRunnerBlock, levelOf$5 as levelOf, enemyOf as m3EnemyOf, levelOf$2 as m3LevelOf, skillOf$2 as m3SkillOf, m3StarsToEnter, match3Block, match3Preset, mergeBlock, mergePreset, metersOf, chainOf as mgChainOf, levelOf$1 as mgLevelOf, skillOf$1 as mgSkillOf, specialOf as mgSpecialOf, mgStarsFor, mgStarsToEnter, migrateSpec, mirrored, offerFromVar, offerToVar, packName, parseKnobPath, patchTargets, patchValue, placeBackdrop, platformerBlock, levelOf$4 as platformerLevelOf, platformerPreset, postApocalypsePack, puzzleCityLink, registerCoreEffects, registerPlatformKit, resolveParams, roundBlock, runnerCollectionLink, runnerPreset, sciFiPack, scrollBackdrop, setPose, shortCash, specForPreset, starsToEnter, startMode, survivorsBlock, survivorsPreset, levelOf$3 as tdLevelOf, starsFor as tdStarsFor, tdStarsToEnter, wavesOf as tdWavesOf, towerArt, towerDefenseBlock, towerDefensePreset, towerOf, towerSpent, towerStats, traceMap, trackControls, botTimeOf as tyBotTimeOf, businessOf as tyBusinessOf, eventOf as tyEventOf, levelOf as tyLevelOf, skillOf as tySkillOf, tyStarsFor, tyStarsToEnter, tycoonBlock, tycoonPreset, tycoonStateOf, validateKnobCatalog, validateSpec, viewOf };