@jgengine/core 0.10.0 → 0.12.0

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,93 @@
+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 { createAuctionBook, type Auction, type AuctionSettlement } from "./economy/auctionBook.js";
+export { createListingBook, type Listing } from "./economy/listingBook.js";
+export { createPriceHistory, type PriceStats, type SaleRecord } from "./economy/priceHistory.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 { 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,93 @@
+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 { createAuctionBook } from "./economy/auctionBook.js";
+export { createListingBook } from "./economy/listingBook.js";
+export { createPriceHistory } from "./economy/priceHistory.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 {} 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,14 +1,5 @@
-export * from "./runtime/save.js";
-export * from "./runtime/snapshot.js";
-export * from "./runtime/worldSnapshot.js";
-export * from "./runtime/worldReplication.js";
-export * from "./game/connectedPlayers.js";
-export * from "./runtime/hostedGameRunner.js";
-export * from "./runtime/hostedWorldSession.js";
-export * from "./runtime/worldMirror.js";
-export * from "./runtime/worldChannel.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,14 +1,5 @@
-export * from "./runtime/save.js";
-export * from "./runtime/snapshot.js";
-export * from "./runtime/worldSnapshot.js";
-export * from "./runtime/worldReplication.js";
-export * from "./game/connectedPlayers.js";
-export * from "./runtime/hostedGameRunner.js";
-export * from "./runtime/hostedWorldSession.js";
-export * from "./runtime/worldMirror.js";
-export * from "./runtime/worldChannel.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";

package/dist/input/actionBindings.d.ts

@@ -10,13 +10,17 @@ export interface ActionBinding<TCode extends string = string> {
     secondary: TCode | null;
 }
 export type ActionBindingMap<TAction extends string, TCode extends string = string> = Record<TAction, ActionBinding<TCode>>;
+/** @internal */
 export declare function bindingMatches<TCode extends string>(code: TCode, binding: ActionBinding<TCode>): boolean;
-/** First action (in the map's key order) bound to the given control code, or null. */
+/** First action (in the map's key order) bound to the given control code, or null.
+ * @internal
+ */
 export declare function resolveBoundAction<TAction extends string, TCode extends string>(code: TCode, bindings: ActionBindingMap<TAction, TCode>): TAction | null;
 /**
  * Collapse left/right modifier variants of a KeyboardEvent.code so bindings
  * store one logical key.
- */
+  * @internal
+  */
 export declare function normalizeKeyCode(code: string): string;
 export interface ActionBindingModes<TCode extends string = string> {
     hold?: ActionBinding<TCode>[];
@@ -31,6 +35,7 @@ export type ActionCodes<TCode extends string = string> = readonly TCode[] | {
 };
 /** Maps each game action name to the input codes (hold/toggle keys, repeat rate) that trigger it. */
 export type ActionCodesMap<TAction extends string = string, TCode extends string = string> = Record<TAction, ActionCodes<TCode>>;
+/** @internal */
 export declare function actionRepeatMs(codes: ActionCodes | undefined): number | undefined;
 export interface ShouldDispatchActionInput {
     pressed: boolean;
@@ -39,24 +44,35 @@ export interface ShouldDispatchActionInput {
     lastFiredAt: number | null;
     now: number;
 }
+/** @internal */
 export declare function shouldDispatchAction({ pressed, down, repeatMs, lastFiredAt, now }: ShouldDispatchActionInput): boolean;
+/** @internal */
 export declare function toActionStateBindingMap<TAction extends string, TCode extends string>(map: ActionCodesMap<TAction, TCode>): ActionStateBindingMap<TAction, TCode>;
+/** @internal */
 export declare function hotbarSlotBindings(count: number, options?: {
     action?: (slot: number) => string;
 }): ActionCodesMap;
-/** 0-based slot index for a hotbar-slot action name (`slot1`, `hotbarSlot1`), or null. */
+/** 0-based slot index for a hotbar-slot action name (`slot1`, `hotbarSlot1`), or null.
+ * @internal
+ */
 export declare function hotbarSlotActionIndex(action: string): number | null;
+/** @internal */
 export declare function isHotbarSlotAction(action: string): boolean;
 /**
  * Convention mapping a bound input action to the command it fires: the action's
  * own name when a command by that name exists, otherwise a `ui.<action>`
  * fallback. Reserved actions (consumed natively by the shell) and hotbar slots
  * yield null so the shell can handle them itself.
- */
+  * @internal
+  */
 export declare function resolveActionCommand(action: string, has: (command: string) => boolean, reserved: ReadonlySet<string>): string | null;
-/** Short display label for a raw key/button code (e.g. `"KeyW"` → `"W"`). */
+/** Short display label for a raw key/button code (e.g. `"KeyW"` → `"W"`).
+ * @internal
+ */
 export declare function bindingLabel(code: string): string;
-/** Short display label for an action's first bound code, or null when unbound. */
+/** Short display label for an action's first bound code, or null when unbound.
+ * @internal
+ */
 export declare function actionLabel(map: ActionCodesMap, action: string): string | null;
 export interface ActionStateTracker<TAction extends string> {
     handleDown(code: string): TAction | null;
@@ -66,4 +82,5 @@ export interface ActionStateTracker<TAction extends string> {
     endFrame(): void;
     reset(): void;
 }
+/** @internal */
 export declare function createActionStateTracker<TAction extends string, TCode extends string = string>(map: ActionStateBindingMap<TAction, TCode>): ActionStateTracker<TAction>;

package/dist/input/actionBindings.js

@@ -5,10 +5,13 @@
  * the same model serves keyboard codes, mouse buttons, touch controls, or
  * gamepad inputs.
  */
+/** @internal */
 export function bindingMatches(code, binding) {
     return code === binding.primary || code === binding.secondary;
 }
-/** First action (in the map's key order) bound to the given control code, or null. */
+/** First action (in the map's key order) bound to the given control code, or null.
+ * @internal
+ */
 export function resolveBoundAction(code, bindings) {
     for (const action of Object.keys(bindings)) {
         if (bindingMatches(code, bindings[action]))
@@ -19,7 +22,8 @@ export function resolveBoundAction(code, bindings) {
 /**
  * Collapse left/right modifier variants of a KeyboardEvent.code so bindings
  * store one logical key.
- */
+  * @internal
+  */
 export function normalizeKeyCode(code) {
     if (code === "ShiftLeft" || code === "ShiftRight")
         return "Shift";
@@ -27,11 +31,13 @@ export function normalizeKeyCode(code) {
         return "Control";
     return code;
 }
+/** @internal */
 export function actionRepeatMs(codes) {
     if (codes === undefined || Array.isArray(codes))
         return undefined;
     return codes.repeatMs;
 }
+/** @internal */
 export function shouldDispatchAction({ pressed, down, repeatMs, lastFiredAt, now }) {
     if (pressed)
         return true;
@@ -44,6 +50,7 @@ export function shouldDispatchAction({ pressed, down, repeatMs, lastFiredAt, now
 function toBindings(codes) {
     return codes.map((code) => ({ primary: code, secondary: null }));
 }
+/** @internal */
 export function toActionStateBindingMap(map) {
     const result = {};
     for (const action of Object.keys(map)) {
@@ -70,6 +77,7 @@ const HOTBAR_DIGIT_CODES = [
     "Digit9",
     "Digit0",
 ];
+/** @internal */
 export function hotbarSlotBindings(count, options) {
     if (!Number.isInteger(count) || count < 1 || count > HOTBAR_DIGIT_CODES.length) {
         throw new Error(`hotbarSlotBindings: count must be an integer in [1, ${HOTBAR_DIGIT_CODES.length}]`);
@@ -82,11 +90,14 @@ export function hotbarSlotBindings(count, options) {
     return map;
 }
 const HOTBAR_SLOT_ACTION = /^(?:hotbar)?slot(\d+)$/i;
-/** 0-based slot index for a hotbar-slot action name (`slot1`, `hotbarSlot1`), or null. */
+/** 0-based slot index for a hotbar-slot action name (`slot1`, `hotbarSlot1`), or null.
+ * @internal
+ */
 export function hotbarSlotActionIndex(action) {
     const match = HOTBAR_SLOT_ACTION.exec(action);
     return match === null ? null : Number(match[1]) - 1;
 }
+/** @internal */
 export function isHotbarSlotAction(action) {
     return HOTBAR_SLOT_ACTION.test(action);
 }
@@ -95,7 +106,8 @@ export function isHotbarSlotAction(action) {
  * own name when a command by that name exists, otherwise a `ui.<action>`
  * fallback. Reserved actions (consumed natively by the shell) and hotbar slots
  * yield null so the shell can handle them itself.
- */
+  * @internal
+  */
 export function resolveActionCommand(action, has, reserved) {
     if (reserved.has(action) || isHotbarSlotAction(action))
         return null;
@@ -127,7 +139,9 @@ const CODE_LABELS = {
     ArrowLeft: "←",
     ArrowRight: "→",
 };
-/** Short display label for a raw key/button code (e.g. `"KeyW"` → `"W"`). */
+/** Short display label for a raw key/button code (e.g. `"KeyW"` → `"W"`).
+ * @internal
+ */
 export function bindingLabel(code) {
     const direct = CODE_LABELS[code];
     if (direct !== undefined)
@@ -138,7 +152,9 @@ export function bindingLabel(code) {
         return code.slice(5);
     return code.length === 1 ? code.toUpperCase() : code;
 }
-/** Short display label for an action's first bound code, or null when unbound. */
+/** Short display label for an action's first bound code, or null when unbound.
+ * @internal
+ */
 export function actionLabel(map, action) {
     const codes = map[action];
     if (codes === undefined)
@@ -159,6 +175,7 @@ function resolveActionBindingModes(config) {
         return { hold: config, toggle: [] };
     return { hold: config.hold ?? [], toggle: config.toggle ?? [] };
 }
+/** @internal */
 export function createActionStateTracker(map) {
     const actions = Object.keys(map);
     const modesByAction = new Map(actions.map((action) => [action, resolveActionBindingModes(map[action])]));