@jgengine/core 0.9.0 → 0.11.0

package/dist/game/vfxInstance.d.ts

@@ -0,0 +1,138 @@
+import type { RetainedVfxKind, VfxRef } from "./events.js";
+/**
+ * The serializable specification for creating (or replacing) a retained VFX instance. Unlike a one-shot
+ * `combat.vfx` burst this describes a long-lived effect whose endpoints and parameters are updated over
+ * time. `id` is caller-stable so repeated `upsert` calls address the same effect; omit it to mint one.
+ * `from`/`to` are {@link VfxRef}s (an entity instance id or a world point) that a renderer resolves each
+ * frame, so an endpoint bound to a moving entity follows it without any per-frame command traffic.
+ */
+export interface VfxInstanceSpec {
+    /** Caller-stable handle. Repeated `upsert` with the same id replaces the instance; omitted mints a fresh id. */
+    id?: string;
+    /** Open effect archetype (e.g. `"beam"`). Renderers register kinds, so new visuals need no central branch. */
+    kind: RetainedVfxKind;
+    /** `0xRRGGBB` tint. */
+    color: number;
+    /** Origin endpoint: an entity instance id (followed live) or a fixed world point. */
+    from?: VfxRef;
+    /** Target endpoint: an entity instance id (followed live) or a fixed world point. */
+    to?: VfxRef;
+    /** Effect radius/thickness in world units, interpreted per kind. */
+    radius?: number;
+    /** Extra numeric knobs a renderer reads by name (intensity, spin, width, ...), kept a flat serializable bag. */
+    params?: Readonly<Record<string, number>>;
+    /** Optional time-to-live in ms: the instance auto-stops if `tick` runs past `ttlMs` since its last touch (heartbeat). */
+    ttlMs?: number;
+}
+/**
+ * The stored, fully-resolved form of a retained VFX instance. It is a plain serializable record so hosts can
+ * replicate it and debug tooling can inspect it; renderers receive it verbatim and never merge partial state
+ * themselves. `updatedAtMs` is the last create/update time and drives TTL heartbeat eviction.
+ */
+export interface VfxInstanceState {
+    /** Stable instance id. */
+    readonly id: string;
+    /** Effect archetype. */
+    readonly kind: RetainedVfxKind;
+    /** `0xRRGGBB` tint. */
+    readonly color: number;
+    /** Origin endpoint, if any. */
+    readonly from?: VfxRef;
+    /** Target endpoint, if any. */
+    readonly to?: VfxRef;
+    /** Effect radius/thickness. */
+    readonly radius?: number;
+    /** Renderer knobs. */
+    readonly params?: Readonly<Record<string, number>>;
+    /** TTL in ms, if the instance heartbeats. */
+    readonly ttlMs?: number;
+    /** Clock time (ms) of the last create/update; the TTL heartbeat measures staleness from here. */
+    readonly updatedAtMs: number;
+}
+/**
+ * A partial update to a live retained VFX instance. Only the provided fields change; `params` is shallow-merged
+ * so a caller can nudge one knob without resending the whole bag. Setting a field to `undefined` clears it.
+ * Applying a patch refreshes the instance heartbeat.
+ */
+export interface VfxInstancePatch {
+    /** New tint. */
+    color?: number;
+    /** New origin endpoint. */
+    from?: VfxRef;
+    /** New target endpoint. */
+    to?: VfxRef;
+    /** New radius/thickness. */
+    radius?: number;
+    /** Knobs shallow-merged into the current `params`. */
+    params?: Readonly<Record<string, number>>;
+}
+/** Options for {@link VfxInstanceStore.stop}. */
+export interface VfxInstanceStopOptions {
+    /** Fade-out duration in ms handed to the renderer; `0` (default) disposes immediately. */
+    fadeMs?: number;
+}
+/**
+ * The lifecycle op a {@link VfxInstanceStore} emits to its renderer sink. `upsert`/`update` carry the full merged
+ * {@link VfxInstanceState} (the renderer applies it directly, no merge); `stop` carries the id plus a fade duration.
+ * This is the payload of the `combat.vfxInstance` game event when the store is wired to the event bus.
+ */
+export interface CombatVfxInstanceEvent {
+    /** `upsert` creates/replaces, `update` mutates dynamic params, `stop` disposes (with optional fade). */
+    readonly op: "upsert" | "update" | "stop";
+    /** The affected instance id. */
+    readonly id: string;
+    /** The full merged state, present for `upsert` and `update`. */
+    readonly instance?: VfxInstanceState;
+    /** Fade-out duration in ms, present for `stop`. */
+    readonly fadeMs?: number;
+}
+/**
+ * A headless registry of retained VFX instances: create/replace, partially update, and stop long-lived effects
+ * addressed by stable id, independent of any renderer. It owns the authoritative serializable state and exposes
+ * inspection counts; wire {@link VfxInstanceStoreOptions.onOp} to a renderer (via the `combat.vfxInstance` event)
+ * to drive visuals.
+ */
+export interface VfxInstanceStore {
+    /**
+     * Create the instance, or replace it in place when its id already exists (idempotent by id). Returns the id
+     * (minted when the spec omits one). Refreshes the heartbeat.
+     */
+    upsert(spec: VfxInstanceSpec): string;
+    /**
+     * Merge `patch` into the live instance and refresh its heartbeat. Returns `false` for an unknown id (a missing
+     * update is a no-op, never a throw), `true` otherwise.
+     */
+    update(id: string, patch: VfxInstancePatch): boolean;
+    /** Dispose the instance, emitting a `stop` op with the resolved fade. Returns `false` for an unknown id. */
+    stop(id: string, options?: VfxInstanceStopOptions): boolean;
+    /** The current state of `id`, or `null` if absent. */
+    get(id: string): VfxInstanceState | null;
+    /** Every live instance, insertion-ordered. */
+    list(): readonly VfxInstanceState[];
+    /** Live instance count, for debug/inspection HUDs. */
+    count(): number;
+    /** Auto-stop instances whose TTL has elapsed as of `nowMs` (defaults to the store clock). Returns the number stopped. */
+    tick(nowMs?: number): number;
+    /** Dispose every instance (scene change / reset), emitting a `stop` op for each. */
+    clear(): void;
+}
+/** Options for {@link createVfxInstanceStore}. */
+export interface VfxInstanceStoreOptions {
+    /** Sink for lifecycle ops; wire to `events.emit("combat.vfxInstance", op)` so the shell renders them. */
+    onOp?: (op: CombatVfxInstanceEvent) => void;
+    /** Injected clock (ms) for heartbeat timestamps and TTL; defaults to `Date.now`. Pass a sim clock for determinism. */
+    now?: () => number;
+    /** Prefix for minted instance ids. Defaults to `"vfx"`. */
+    idPrefix?: string;
+}
+/**
+ * Build a headless retained-VFX registry. The store is the serializable source of truth for long-lived effects
+ * (beams, tethers, zones, target lines, looping emitters) that must move and mutate without one-shot re-emit
+ * flicker: `upsert` creates or replaces by stable id, `update` nudges dynamic params, `stop` disposes with an
+ * optional fade, and `tick` enforces TTL heartbeats. It stays independent of renderer availability, so simulation
+ * and tests run without a shell; a wired `onOp` sink turns each op into a `combat.vfxInstance` event the shell
+ * binds to render resources.
+ *
+ * @capability retained-vfx create/update/stop long-lived dynamic visual effects (beam, tether, zone, target line) by stable id
+ */
+export declare function createVfxInstanceStore(options?: VfxInstanceStoreOptions): VfxInstanceStore;

package/dist/game/vfxInstance.js

@@ -0,0 +1,96 @@
+function cloneParams(params) {
+    return params === undefined ? undefined : { ...params };
+}
+/**
+ * Build a headless retained-VFX registry. The store is the serializable source of truth for long-lived effects
+ * (beams, tethers, zones, target lines, looping emitters) that must move and mutate without one-shot re-emit
+ * flicker: `upsert` creates or replaces by stable id, `update` nudges dynamic params, `stop` disposes with an
+ * optional fade, and `tick` enforces TTL heartbeats. It stays independent of renderer availability, so simulation
+ * and tests run without a shell; a wired `onOp` sink turns each op into a `combat.vfxInstance` event the shell
+ * binds to render resources.
+ *
+ * @capability retained-vfx create/update/stop long-lived dynamic visual effects (beam, tether, zone, target line) by stable id
+ */
+export function createVfxInstanceStore(options = {}) {
+    const onOp = options.onOp;
+    const now = options.now ?? (() => Date.now());
+    const idPrefix = options.idPrefix ?? "vfx";
+    const instances = new Map();
+    let seq = 0;
+    function emit(op) {
+        onOp?.(op);
+    }
+    function upsert(spec) {
+        const id = spec.id ?? `${idPrefix}-${seq++}`;
+        const state = {
+            id,
+            kind: spec.kind,
+            color: spec.color,
+            ...(spec.from === undefined ? {} : { from: spec.from }),
+            ...(spec.to === undefined ? {} : { to: spec.to }),
+            ...(spec.radius === undefined ? {} : { radius: spec.radius }),
+            ...(spec.params === undefined ? {} : { params: cloneParams(spec.params) }),
+            ...(spec.ttlMs === undefined ? {} : { ttlMs: spec.ttlMs }),
+            updatedAtMs: now(),
+        };
+        instances.set(id, state);
+        emit({ op: "upsert", id, instance: state });
+        return id;
+    }
+    function update(id, patch) {
+        const current = instances.get(id);
+        if (current === undefined)
+            return false;
+        const mergedParams = patch.params === undefined ? current.params : { ...(current.params ?? {}), ...patch.params };
+        const nextFrom = "from" in patch ? patch.from : current.from;
+        const nextTo = "to" in patch ? patch.to : current.to;
+        const nextRadius = "radius" in patch ? patch.radius : current.radius;
+        const next = {
+            id: current.id,
+            kind: current.kind,
+            color: patch.color ?? current.color,
+            ...(nextFrom === undefined ? {} : { from: nextFrom }),
+            ...(nextTo === undefined ? {} : { to: nextTo }),
+            ...(nextRadius === undefined ? {} : { radius: nextRadius }),
+            ...(mergedParams === undefined ? {} : { params: cloneParams(mergedParams) }),
+            ...(current.ttlMs === undefined ? {} : { ttlMs: current.ttlMs }),
+            updatedAtMs: now(),
+        };
+        instances.set(id, next);
+        emit({ op: "update", id, instance: next });
+        return true;
+    }
+    function stop(id, stopOptions = {}) {
+        if (!instances.has(id))
+            return false;
+        instances.delete(id);
+        emit({ op: "stop", id, fadeMs: stopOptions.fadeMs ?? 0 });
+        return true;
+    }
+    function get(id) {
+        return instances.get(id) ?? null;
+    }
+    function list() {
+        return [...instances.values()];
+    }
+    function count() {
+        return instances.size;
+    }
+    function tick(nowMs = now()) {
+        let stopped = 0;
+        for (const state of [...instances.values()]) {
+            if (state.ttlMs === undefined)
+                continue;
+            if (nowMs - state.updatedAtMs >= state.ttlMs) {
+                if (stop(state.id))
+                    stopped += 1;
+            }
+        }
+        return stopped;
+    }
+    function clear() {
+        for (const id of [...instances.keys()])
+            stop(id);
+    }
+    return { upsert, update, stop, get, list, count, tick, clear };
+}

package/dist/game/worldItem.d.ts

@@ -11,8 +11,11 @@ export interface ScatterOptions {
     height?: number;
 }
 export declare const DEFAULT_SCATTER: ScatterOptions;
-/** Random offset within an annulus `[minRadius, radius]` around the origin — the on-death scatter impulse. */
+/** Random offset within an annulus `[minRadius, radius]` around the origin — the on-death scatter impulse.
+ * @internal
+ */
 export declare function scatterOffset(rng: () => number, options?: ScatterOptions): EntityPosition;
+/** @internal */
 export declare function scatterPosition(origin: EntityPosition, rng: () => number, options?: ScatterOptions): EntityPosition;
 export interface WorldItemRecord {
     instanceId: string;
@@ -49,11 +52,19 @@ export interface WorldItemStore {
     /** Consumes/destroys the record with no grant implied (decay, an explosion, a cleanup sweep) — same despawn path as `take`, leaves no orphaned record. */
     remove(instanceId: string): WorldItemRecord | null;
 }
-/** Pure pickup-radius + nearest-item selection, usable without a live store (click-to-grab, proximity prompts). */
+/** Pure pickup-radius + nearest-item selection, usable without a live store (click-to-grab, proximity prompts).
+ * @internal
+ */
 export declare function selectNearestWorldItem(candidates: readonly {
     instanceId: string;
     position: EntityPosition;
 }[], from: EntityPosition, radius: number): string | null;
+/**
+ * Spawn and track pickup-able items scattered in the world, including drops that scatter on death.
+ *
+ * @capability world-drops spawn pickup-able items in the world, including death drops
+  * @internal
+  */
 export declare function createWorldItemStore(deps: WorldItemStoreDeps): WorldItemStore;
 export interface ResolveDeathDropsOptions {
     mode: "grant" | "world";
@@ -73,7 +84,8 @@ export interface ResolvedDeathDrops {
  * `mode: "grant"` is the legacy behavior (loot straight to inventory); `mode:
  * "world"` routes item drops through a scatter impulse and leaves currency
  * drops granting directly (coins fly to the killer, gear hits the ground).
- */
+  * @internal
+  */
 export declare function resolveDeathDrops(drops: readonly Drop[], options: ResolveDeathDropsOptions): ResolvedDeathDrops;
 export interface RarityStyle {
     color?: string;
@@ -91,5 +103,6 @@ export interface WorldItemPresentation {
  * data the game supplies) with the loot-filter rule overrides (#33). A
  * matching rule wins field-by-field; unmatched fields fall back to the
  * rarity's baseline style.
- */
+  * @internal
+  */
 export declare function resolveWorldItemPresentation(item: LootFilterItem, rarityStyle: Record<string, RarityStyle> | undefined, rules: readonly LootFilterRule[] | undefined): WorldItemPresentation;

package/dist/game/worldItem.js

@@ -5,7 +5,9 @@ export const WORLD_ITEM_ENTITY_NAME = "world_item";
 export const DEFAULT_RARITY = "common";
 export const DEFAULT_PICKUP_RADIUS = 2;
 export const DEFAULT_SCATTER = { radius: 1.5, minRadius: 0.4, height: 0 };
-/** Random offset within an annulus `[minRadius, radius]` around the origin — the on-death scatter impulse. */
+/** Random offset within an annulus `[minRadius, radius]` around the origin — the on-death scatter impulse.
+ * @internal
+ */
 export function scatterOffset(rng, options = DEFAULT_SCATTER) {
     const angle = rng() * Math.PI * 2;
     const min = options.minRadius ?? 0;
@@ -13,11 +15,14 @@ export function scatterOffset(rng, options = DEFAULT_SCATTER) {
     const distance = min + rng() * span;
     return [Math.cos(angle) * distance, options.height ?? 0, Math.sin(angle) * distance];
 }
+/** @internal */
 export function scatterPosition(origin, rng, options = DEFAULT_SCATTER) {
     const offset = scatterOffset(rng, options);
     return [origin[0] + offset[0], origin[1] + offset[1], origin[2] + offset[2]];
 }
-/** Pure pickup-radius + nearest-item selection, usable without a live store (click-to-grab, proximity prompts). */
+/** Pure pickup-radius + nearest-item selection, usable without a live store (click-to-grab, proximity prompts).
+ * @internal
+ */
 export function selectNearestWorldItem(candidates, from, radius) {
     let bestId = null;
     let bestDistance = Number.POSITIVE_INFINITY;
@@ -30,6 +35,12 @@ export function selectNearestWorldItem(candidates, from, radius) {
     }
     return bestId;
 }
+/**
+ * Spawn and track pickup-able items scattered in the world, including drops that scatter on death.
+ *
+ * @capability world-drops spawn pickup-able items in the world, including death drops
+  * @internal
+  */
 export function createWorldItemStore(deps) {
     const records = new Map();
     const now = deps.now ?? Date.now;
@@ -89,7 +100,8 @@ export function createWorldItemStore(deps) {
  * `mode: "grant"` is the legacy behavior (loot straight to inventory); `mode:
  * "world"` routes item drops through a scatter impulse and leaves currency
  * drops granting directly (coins fly to the killer, gear hits the ground).
- */
+  * @internal
+  */
 export function resolveDeathDrops(drops, options) {
     if (options.mode !== "world")
         return { worldSpawns: [], grants: [...drops] };
@@ -120,7 +132,8 @@ export function resolveDeathDrops(drops, options) {
  * data the game supplies) with the loot-filter rule overrides (#33). A
  * matching rule wins field-by-field; unmatched fields fall back to the
  * rarity's baseline style.
- */
+  * @internal
+  */
 export function resolveWorldItemPresentation(item, rarityStyle, rules) {
     const base = rarityStyle?.[item.rarity];
     const override = rules === undefined || rules.length === 0 ? {} : evaluateLootFilter(rules, item);

package/dist/gameplay.d.ts

@@ -0,0 +1,91 @@
+export { Behaviour, BehaviourModule, createBehaviourWorld, type BehaviourWorld } from "./behaviour/behaviour.js";
+export { type LaneRule } from "./board/laneBoard.js";
+export { createCardPile, createCardPileState, draw, moveCards, peek, pileRng, shuffleWithRng, type CardPile, type CardPileState, } from "./cards/cardPile.js";
+export { runPipeline } from "./cards/modifierPipeline.js";
+export { type CropDef, type CropTileState } from "./crafting/crop.js";
+export { advanceTransport, createProductionState, drainOutput, feedProduction, productionBuilding, resolvePowerGrid, tickProduction, } from "./crafting/production.js";
+export { canCraft, craft, craftSeconds, createRecipeGraph, stationSatisfied, type RecipeDef, type RecipeItem, } from "./crafting/recipe.js";
+export { createListingBook, type Listing } from "./economy/listingBook.js";
+export { addScheduledRule, advanceLedger, annotate, balanceOf, cancelRule, capAmount, createResourceLedger, curveScale, pauseRule, redirect, rejectWhen, resumeRule, taxFraction, thresholdScale, type AdvanceOptions, type AdvanceResult, type AppliedTransaction, type CatchUpPolicy, type LedgerEvent, type LedgerEventKind, type PolicyContext, type PolicyRead, type Precision, type ResourceLedger, type ResourcePolicy, type ResourceTransaction, type RuleCursor, type ScheduledRule, type ThresholdBand, } from "./economy/resourceLedger.js";
+export { type TechNodeDef } from "./economy/techTree.js";
+export { balance, charge, chargeAll, createEmptyWallet, grant, isOverdrawn } from "./economy/wallet.js";
+export { DEFAULT_CHAT_BODY_LENGTH, DEFAULT_CHAT_HISTORY_LIMIT, DEFAULT_CHAT_RATE_LIMIT, createChatRateLimiter, type Chat, type ChatMessage, type ChatRateLimit, type ChatSendResult, } from "./game/chat.js";
+export { playControlsActive } from "./game/controlGate.js";
+export { createCosmetics } from "./game/cosmetics.js";
+export { defineGame, type GameDefinition, type GameDefinitionConfig, type GameLoop, type InventoryDeclaration, type LifecycleConfig, type PhysicsConfig, } from "./game/defineGame.js";
+export { defineSystem, type SystemDefinition, type SystemEventHandlers, type SystemTick } from "./game/defineSystem.js";
+export { createGameDialogue, dialogueSlot } from "./game/dialogue.js";
+export { createGameEvents, type CombatTelegraphEvent, type CombatVfxEvent, type EntityDiedEvent, type EntityFloatTextEvent, type GameEventMap, type GameEvents, type RetainedVfxKind, type StatLevelUpEvent, type VfxKind, type VfxRef, } from "./game/events.js";
+export { appendFeed, createGameFeed, pruneFeed, type FeedEntry, type FeedWindow, type TimedFeedEntry, } from "./game/feed.js";
+export { gamePhase, setGamePhase, type GamePhase } from "./game/gamePhase.js";
+export { createKeyValueStore, type KeyValueStorage } from "./game/keyValueStore.js";
+export { createLeaderboard, type LeaderboardRow, type LeaderboardScope } from "./game/leaderboard.js";
+export { createLevelSequence, type LevelSequence } from "./game/levelSequence.js";
+export { createLoadouts, type LoadoutDef } from "./game/loadout.js";
+export { evaluateLootFilter, lootFilter, type LootFilterRule } from "./game/lootFilter.js";
+export { createLootPipeline, defineLootPipeline, type LootDropProvenance, type LootModifier, type LootPipeline, type LootPipelineDef, type LootPipelineDeps, type LootPlanEntry, type LootResolution, type LootResolveContext, type LootRollPlan, type LootStage, type LootStageKind, type LootStageStatus, type LootStageTrace, } from "./game/lootPipeline.js";
+export { createLootRegistry, lootTable, type Drop, type LootTableDef } from "./game/lootTable.js";
+export { resolveOneShotClip } from "./game/modelAnimation.js";
+export { evaluateObjective } from "./game/objectives.js";
+export { createLayerRegistry, diffParams, orderLayers, resolveParams, resolveSelection, validateLayers, type LayerConflict, type LayerOps, type LayerRegistry, type LayerSelection, type ParamContribution, type ParamDelta, type ParamLayer, type ParamOp, type ParamSnapshot, } from "./game/paramLayers.js";
+export { DEFAULT_PING_CATEGORIES, PING_FEED_ACTION, createPingSystem, type PingCategory, type PingSystem, } from "./game/ping.js";
+export { CAMERA_FRUSTUM_DEFAULTS, worldHealthBarAllowsRole, type BackdropConfig, type CameraKeyframe, type CameraRigKind, type ChaseCameraConfig, type CinematicCameraConfig, type DirectionalLightingConfig, type EntitySpriteConfig, type FirstPersonCameraConfig, type GameCameraConfig, type InspectionCameraConfig, type InspectionZoomAnchor, type LightingConfig, type LockOnCameraConfig, type ModelConfig, type ModelMaterialMaps, type ModelMaterialOverride, type ObjectStyle, type ObserverCameraConfig, type PlayableGame, type PointerConfig, type RtsCameraConfig, type ShoulderCameraConfig, type SideScrollCameraConfig, type TopDownCameraConfig, type WorldItemRenderConfig, type WorldOverlayProps, } from "./game/playableGame.js";
+export { curve, evalCurve, leveling, type Curve, type LevelProgress, type LevelingConfig, type LevelingTrack, } from "./game/progression.js";
+export { createQuestJournal, type QuestDef, type QuestInstance, type QuestRewards } from "./game/quest.js";
+export { RaceState, createLapTimer, createRaceState, finishRaceSession, firstPastPost, idleRaceSession, lapDurations, parDelta, placementOf, raceOutcomeOf, racePlacements, raceTrack, splitSegments, startRaceCountdown, tickRaceSession, } from "./game/race.js";
+export { createRecordBook } from "./game/recordBook.js";
+export { createRuleRegistry, rerollRules, selectRules, type RuleDef, type RuleRegistry, type RuleSelection, type RuleSelectionConfig, } from "./game/ruleSelection.js";
+export { createRunDraft, type RunDraft, type RunModifierOffer } from "./game/runDraft.js";
+export { createSaveStore, localSaveBackend, memorySaveBackend, remoteSaveBackend, type SaveBackend, type SaveStatus, type SaveStore, } from "./game/saveStore.js";
+export { createSocial, type FriendEntry, type FriendRequestEntry, type Friends, type Party, type PartyInviteEntry, type PartyMemberEntry, type PresenceInfo, type Social, type SocialDeps, type WorldInvite, type WorldInviteTarget, } from "./game/social.js";
+export { createSpawnPoints } from "./game/spawnPoints.js";
+export { composeGameLoop } from "./game/systemRuntime.js";
+export { DEFAULT_FIXED_STAGES, DEFAULT_FRAME_STAGES, compileSystemSchedule, type CompiledSystemSchedule, } from "./game/systemSchedule.js";
+export { createTalentTree, type TalentNodeDef, type TalentTree } from "./game/talents.js";
+export { appendToast, createToastQueue, pruneToasts, type Toast } from "./game/toasts.js";
+export { createUnlockCatalog, createUnlocks, type UnlockDef } from "./game/unlocks.js";
+export { createVfxInstanceStore, type CombatVfxInstanceEvent, type VfxInstancePatch, type VfxInstanceSpec, type VfxInstanceState, type VfxInstanceStopOptions, type VfxInstanceStore, type VfxInstanceStoreOptions, } from "./game/vfxInstance.js";
+export { DEFAULT_PICKUP_RADIUS, WORLD_ITEM_ENTITY_NAME, type RarityStyle, type WorldItemRecord, } from "./game/worldItem.js";
+export { type ActionCodes, type ActionCodesMap, type ActionStateTracker } from "./input/actionBindings.js";
+export { NEUTRAL_AXIS, type AxisBindingMap, type AxisChannelConfig, type AxisInput } from "./input/axisInput.js";
+export { applyBindingOverrides, clearBindingOverride, loadBindingOverrides, saveBindingOverride, type BindingOverrides, } from "./input/bindingOverrides.js";
+export { createGestureSurfaceTracker } from "./input/gestureSurface.js";
+export { aimToPoint, type PointerHit, type PointerVec3 } from "./input/pointer.js";
+export { normalizePointerToAxis, type PointerAxisState } from "./input/pointerAxis.js";
+export { createTouchGestureTracker } from "./input/touchGestures.js";
+export { DEFAULT_TOUCH_STYLE, TOUCH_STYLES, TOUCH_STYLE_OPTIONS, deriveTouchScheme, touchButtonShape, touchCode, withTouchCodes, type TouchAnchor, type TouchButton, type TouchButtonShape, type TouchJoystick, type TouchScheme, type TouchStyle, } from "./input/touchScheme.js";
+export { type InventorySlot, type InventoryState } from "./inventory/inventoryModel.js";
+export { type Cell, type Rotation } from "./inventory/shapedGrid.js";
+export { type SlotGrid } from "./inventory/slotModel.js";
+export { createDeliveryQueue, insureLost, partitionOnDeath, resolveConsolation, type DeliveryEntry, type DeliveryQueue, type ScheduledDelivery, } from "./inventory/storageTier.js";
+export { createAffixRoller, seededRng, type AffixPool } from "./item/affix.js";
+export { applyWear, createDurability, createDurabilityTracker, durabilityFraction, isDisabled, repairQuote, wear, type DurabilitySpec, type DurabilityState, } from "./item/durability.js";
+export { activeSetBonuses, applySetBonuses, candidateViolatesForbid, captureProvenance, countSetMembers, identityOf, isIdentityValid, matchesQuery, validateIdentity, type CandidatePlacement, type CompatibilityRule, type ConstraintViolation, type ForbidRule, type IdentityQuery, type ItemIdentity, type ItemProvenance, type RequireRule, type SetBonus, } from "./item/itemIdentity.js";
+export { createItemInstanceRegistry, proceduralLootEntry } from "./item/itemInstanceRegistry.js";
+export { generate, type GenChoiceRecord, type GenChoices, type GenDraft, type GenFieldRecord, type GenOption, type GenOutcome, type GenPool, type GenProvenance, type GenResult, type GenSchema, type GenStep, type GenTransform, type GenValidator, type GenerateOptions, type TransformApi, } from "./item/itemgen.js";
+export { computeEffectiveStats, createModularItem, install, isComplete, missingRequiredSlots, partInSlot, slotAccepts, uninstall, type InstalledPart, type ModularItemDef, type MountSlotDef, type PartDef, } from "./item/modularItem.js";
+export { createItemUse, type ItemUseHandler, type ItemUseInput } from "./item/use.js";
+export { createUseBehaviorRegistry, type BehaviorConfig, type BehaviorState, type ComposedUse, type CompositionResult, type SerializedBehaviorState, type UseBehaviorContext, type UseBehaviorDef, type UseBehaviorOutcome, type UseBehaviorRef, type UseBehaviorRegistry, type UseBehaviorRejection, } from "./item/useBehavior.js";
+export { createWeaponStats } from "./item/weapon.js";
+export { createStatGraph, statModifierContributions, type StatContribution, type StatContributionStep, type StatDeriveContext, type StatDerivedDef, type StatExplanation, type StatGraph, type StatGraphDef, type StatInputDef, type StatModEntry, type StatOp, type StatSheet, type StatSheetState, } from "./progression/statGraph.js";
+export { type CellGrid } from "./puzzle/cellGrid.js";
+export { type ShapeTable } from "./puzzle/fallingPiece.js";
+export { createNameGenerator } from "./random/nameGen.js";
+export { pickUniform, pickWeighted } from "./random/pick.js";
+export { seededStreams } from "./random/rng.js";
+export { addValue, clampValue, createPairKeyCodec, driftValue, getValue, setValue, towardValue, type NumericBounds, type PairKeyCodec, type PairKeyOptions, } from "./relation/keyedValues.js";
+export { crossThresholds, tierAt, type CrossThresholdsOptions, type ThresholdBoundary, type ThresholdCrossing, type ThresholdDirection, } from "./relation/thresholds.js";
+export { evaluatePredicate, readPath, type Predicate, type PredicateFacts, type PredicatePath, type PredicateValue, } from "./rules/predicate.js";
+export { getRuleEffect, listRuleEffects, registerRuleEffect, type RuleEffectDefinition } from "./rules/ruleEffects.js";
+export { createTriggeredRuleEngine, type ActiveEffect, type EffectRef, type FiringBlock, type RateLimit, type RuleEvent, type RuleFiring, type StackPolicy, type TargetRole, type TargetSelector, type TriggeredRule, type TriggeredRuleEngine, type TriggeredRuleState, } from "./rules/triggeredRules.js";
+export { createRing, ringSampleAt, type Ring, type RingConfig, type RingPhase } from "./session/ring.js";
+export { type RoleSpec } from "./session/roles.js";
+export { type RoundConfig, type RoundSnapshot } from "./session/roundState.js";
+export { createDecayMeterSet, decayMeterMoodles, decayMeterSnapshot, decayMeterState, decayMeters, initDecayMeters, refillMeter, type DecayMeterSet, type DecayMeterValues, type DecayModifier, } from "./survival/decayMeter.js";
+export { createMoodleStack, stackMoodles, type Moodle, type MoodleStack } from "./survival/moodle.js";
+export { createMultiRegionHealth, type MultiRegionHealth } from "./survival/regionHealth.js";
+export { createCommitController } from "./turn/commit.js";
+export { createIntentBoard } from "./turn/intent.js";
+export { createTurnLoop, type TurnLoop } from "./turn/turnLoop.js";
+export { activeJobs, cancelJob, createWorkQueue, enqueue, fifoOrdering, jobById, jobProgress, pauseJob, priorityOrdering, queueSize, queuedJobs, resumeJob, tick, type CancelResult, type EnqueueOptions, type EnqueueResult, type Job, type JobId, type JobOrdering, type JobStatus, type JobValidation, type TickResult, type WorkQueueConfig, type WorkQueueEvent, type WorkQueueState, } from "./work/jobQueue.js";
+export { unitTrainingConfig, type ResourceCost, type TrainableUnitDef, type UnitReservation, type UnitSpawnOrder, type UnitTrainingOptions, type UnitTrainingSpec, } from "./work/unitTraining.js";

package/dist/gameplay.js

@@ -0,0 +1,91 @@
+export { Behaviour, BehaviourModule, createBehaviourWorld } from "./behaviour/behaviour.js";
+export {} from "./board/laneBoard.js";
+export { createCardPile, createCardPileState, draw, moveCards, peek, pileRng, shuffleWithRng, } from "./cards/cardPile.js";
+export { runPipeline } from "./cards/modifierPipeline.js";
+export {} from "./crafting/crop.js";
+export { advanceTransport, createProductionState, drainOutput, feedProduction, productionBuilding, resolvePowerGrid, tickProduction, } from "./crafting/production.js";
+export { canCraft, craft, craftSeconds, createRecipeGraph, stationSatisfied, } from "./crafting/recipe.js";
+export { createListingBook } from "./economy/listingBook.js";
+export { addScheduledRule, advanceLedger, annotate, balanceOf, cancelRule, capAmount, createResourceLedger, curveScale, pauseRule, redirect, rejectWhen, resumeRule, taxFraction, thresholdScale, } from "./economy/resourceLedger.js";
+export {} from "./economy/techTree.js";
+export { balance, charge, chargeAll, createEmptyWallet, grant, isOverdrawn } from "./economy/wallet.js";
+export { DEFAULT_CHAT_BODY_LENGTH, DEFAULT_CHAT_HISTORY_LIMIT, DEFAULT_CHAT_RATE_LIMIT, createChatRateLimiter, } from "./game/chat.js";
+export { playControlsActive } from "./game/controlGate.js";
+export { createCosmetics } from "./game/cosmetics.js";
+export { defineGame, } from "./game/defineGame.js";
+export { defineSystem } from "./game/defineSystem.js";
+export { createGameDialogue, dialogueSlot } from "./game/dialogue.js";
+export { createGameEvents, } from "./game/events.js";
+export { appendFeed, createGameFeed, pruneFeed, } from "./game/feed.js";
+export { gamePhase, setGamePhase } from "./game/gamePhase.js";
+export { createKeyValueStore } from "./game/keyValueStore.js";
+export { createLeaderboard } from "./game/leaderboard.js";
+export { createLevelSequence } from "./game/levelSequence.js";
+export { createLoadouts } from "./game/loadout.js";
+export { evaluateLootFilter, lootFilter } from "./game/lootFilter.js";
+export { createLootPipeline, defineLootPipeline, } from "./game/lootPipeline.js";
+export { createLootRegistry, lootTable } from "./game/lootTable.js";
+export { resolveOneShotClip } from "./game/modelAnimation.js";
+export { evaluateObjective } from "./game/objectives.js";
+export { createLayerRegistry, diffParams, orderLayers, resolveParams, resolveSelection, validateLayers, } from "./game/paramLayers.js";
+export { DEFAULT_PING_CATEGORIES, PING_FEED_ACTION, createPingSystem, } from "./game/ping.js";
+export { CAMERA_FRUSTUM_DEFAULTS, worldHealthBarAllowsRole, } from "./game/playableGame.js";
+export { curve, evalCurve, leveling, } from "./game/progression.js";
+export { createQuestJournal } from "./game/quest.js";
+export { RaceState, createLapTimer, createRaceState, finishRaceSession, firstPastPost, idleRaceSession, lapDurations, parDelta, placementOf, raceOutcomeOf, racePlacements, raceTrack, splitSegments, startRaceCountdown, tickRaceSession, } from "./game/race.js";
+export { createRecordBook } from "./game/recordBook.js";
+export { createRuleRegistry, rerollRules, selectRules, } from "./game/ruleSelection.js";
+export { createRunDraft } from "./game/runDraft.js";
+export { createSaveStore, localSaveBackend, memorySaveBackend, remoteSaveBackend, } from "./game/saveStore.js";
+export { createSocial, } from "./game/social.js";
+export { createSpawnPoints } from "./game/spawnPoints.js";
+export { composeGameLoop } from "./game/systemRuntime.js";
+export { DEFAULT_FIXED_STAGES, DEFAULT_FRAME_STAGES, compileSystemSchedule, } from "./game/systemSchedule.js";
+export { createTalentTree } from "./game/talents.js";
+export { appendToast, createToastQueue, pruneToasts } from "./game/toasts.js";
+export { createUnlockCatalog, createUnlocks } from "./game/unlocks.js";
+export { createVfxInstanceStore, } from "./game/vfxInstance.js";
+export { DEFAULT_PICKUP_RADIUS, WORLD_ITEM_ENTITY_NAME, } from "./game/worldItem.js";
+export {} from "./input/actionBindings.js";
+export { NEUTRAL_AXIS } from "./input/axisInput.js";
+export { applyBindingOverrides, clearBindingOverride, loadBindingOverrides, saveBindingOverride, } from "./input/bindingOverrides.js";
+export { createGestureSurfaceTracker } from "./input/gestureSurface.js";
+export { aimToPoint } from "./input/pointer.js";
+export { normalizePointerToAxis } from "./input/pointerAxis.js";
+export { createTouchGestureTracker } from "./input/touchGestures.js";
+export { DEFAULT_TOUCH_STYLE, TOUCH_STYLES, TOUCH_STYLE_OPTIONS, deriveTouchScheme, touchButtonShape, touchCode, withTouchCodes, } from "./input/touchScheme.js";
+export {} from "./inventory/inventoryModel.js";
+export {} from "./inventory/shapedGrid.js";
+export {} from "./inventory/slotModel.js";
+export { createDeliveryQueue, insureLost, partitionOnDeath, resolveConsolation, } from "./inventory/storageTier.js";
+export { createAffixRoller, seededRng } from "./item/affix.js";
+export { applyWear, createDurability, createDurabilityTracker, durabilityFraction, isDisabled, repairQuote, wear, } from "./item/durability.js";
+export { activeSetBonuses, applySetBonuses, candidateViolatesForbid, captureProvenance, countSetMembers, identityOf, isIdentityValid, matchesQuery, validateIdentity, } from "./item/itemIdentity.js";
+export { createItemInstanceRegistry, proceduralLootEntry } from "./item/itemInstanceRegistry.js";
+export { generate, } from "./item/itemgen.js";
+export { computeEffectiveStats, createModularItem, install, isComplete, missingRequiredSlots, partInSlot, slotAccepts, uninstall, } from "./item/modularItem.js";
+export { createItemUse } from "./item/use.js";
+export { createUseBehaviorRegistry, } from "./item/useBehavior.js";
+export { createWeaponStats } from "./item/weapon.js";
+export { createStatGraph, statModifierContributions, } from "./progression/statGraph.js";
+export {} from "./puzzle/cellGrid.js";
+export {} from "./puzzle/fallingPiece.js";
+export { createNameGenerator } from "./random/nameGen.js";
+export { pickUniform, pickWeighted } from "./random/pick.js";
+export { seededStreams } from "./random/rng.js";
+export { addValue, clampValue, createPairKeyCodec, driftValue, getValue, setValue, towardValue, } from "./relation/keyedValues.js";
+export { crossThresholds, tierAt, } from "./relation/thresholds.js";
+export { evaluatePredicate, readPath, } from "./rules/predicate.js";
+export { getRuleEffect, listRuleEffects, registerRuleEffect } from "./rules/ruleEffects.js";
+export { createTriggeredRuleEngine, } from "./rules/triggeredRules.js";
+export { createRing, ringSampleAt } from "./session/ring.js";
+export {} from "./session/roles.js";
+export {} from "./session/roundState.js";
+export { createDecayMeterSet, decayMeterMoodles, decayMeterSnapshot, decayMeterState, decayMeters, initDecayMeters, refillMeter, } from "./survival/decayMeter.js";
+export { createMoodleStack, stackMoodles } from "./survival/moodle.js";
+export { createMultiRegionHealth } from "./survival/regionHealth.js";
+export { createCommitController } from "./turn/commit.js";
+export { createIntentBoard } from "./turn/intent.js";
+export { createTurnLoop } from "./turn/turnLoop.js";
+export { activeJobs, cancelJob, createWorkQueue, enqueue, fifoOrdering, jobById, jobProgress, pauseJob, priorityOrdering, queueSize, queuedJobs, resumeJob, tick, } from "./work/jobQueue.js";
+export { unitTrainingConfig, } from "./work/unitTraining.js";

package/dist/index.d.ts

@@ -1,7 +1,5 @@
-export * from "./runtime/save.js";
-export * from "./runtime/snapshot.js";
-export * from "./runtime/commandRunner.js";
-export * from "./runtime/gameRuntime.js";
-export * from "./runtime/adapter.js";
-export * from "./runtime/transport.js";
-export * from "./runtime/visibility.js";
+/**
+ * Package root — deep-path imports only for engine APIs (`@jgengine/core/<domain>/<file>`).
+ * Re-exports {@link VERSION} / {@link CHANGELOG} so `import { VERSION } from "@jgengine/core"` works.
+ */
+export { VERSION, CHANGELOG, type ChangelogEntry } from "./meta/changelog.js";

package/dist/index.js

@@ -1,7 +1,5 @@
-export * from "./runtime/save.js";
-export * from "./runtime/snapshot.js";
-export * from "./runtime/commandRunner.js";
-export * from "./runtime/gameRuntime.js";
-export * from "./runtime/adapter.js";
-export * from "./runtime/transport.js";
-export * from "./runtime/visibility.js";
+/**
+ * Package root — deep-path imports only for engine APIs (`@jgengine/core/<domain>/<file>`).
+ * Re-exports {@link VERSION} / {@link CHANGELOG} so `import { VERSION } from "@jgengine/core"` works.
+ */
+export { VERSION, CHANGELOG } from "./meta/changelog.js";