@its-not-rocket-science/ananke 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -10,6 +10,20 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.3] — 2026-03-20
+
+### Changed
+
+- `src/index.ts` (CE-4) now exports only the Tier 1 stable surface defined in `STABLE_API.md`.
+  Tier 2 (experimental) and Tier 3 (internal) exports have been removed from the root barrel
+  and are accessible via direct module paths (e.g. `dist/src/sim/aging.js`).
+- `createWorld`, `loadScenario`, `validateScenario`, `ARCHETYPE_MAP`, `ITEM_MAP` promoted to
+  Tier 1 (were incorrectly placed under Tier 3 in 0.1.2).
+- `describeCharacter`, `formatCharacterSheet`, `formatOneLine` added to root barrel (were
+  listed as Tier 1 in `STABLE_API.md` but missing from the 0.1.2 export).
+
+---
+
 ## [0.1.2] — 2026-03-19
 
 ### Added

package/dist/src/index.d.ts

@@ -3,6 +3,7 @@ export * from "./types.js";
 export * from "./archetypes.js";
 export * from "./generate.js";
 export * from "./equipment.js";
+export * from "./describe.js";
 export * from "./sim/vec3.js";
 export * from "./sim/condition.js";
 export * from "./sim/injury.js";
@@ -14,31 +15,5 @@ export * from "./sim/world.js";
 export * from "./model3d.js";
 export * from "./replay.js";
 export * from "./bridge/index.js";
-export * from "./channels.js";
-export * from "./traits.js";
-export * from "./derive.js";
-export * from "./sim/intent.js";
-export * from "./sim/action.js";
-export * from "./sim/combat.js";
-export * from "./quest.js";
-export * from "./quest-generators.js";
-export * from "./relationships.js";
-export * from "./relationships-effects.js";
-export * from "./inventory.js";
-export * from "./item-durability.js";
-export * from "./settlement.js";
-export * from "./settlement-services.js";
-export * from "./chronicle.js";
-export * from "./story-arcs.js";
-export * from "./narrative-render.js";
-export * from "./world-generation.js";
-export * from "./sim/trace.js";
-export * from "./rng.js";
-export * from "./dist.js";
-export * from "./lod.js";
-export * from "./sim/impairment.js";
-export * from "./sim/indexing.js";
-export * from "./sim/tuning.js";
-export * from "./sim/testing.js";
 export * from "./world-factory.js";
 export * from "./scenario.js";

package/dist/src/index.js

@@ -1,56 +1,28 @@
 // ── Tier 1 — Stable host API ─────────────────────────────────────────────────
-// These exports form the public integration surface.  Breaking changes require
-// a major semver bump (x.0.0) and a migration guide in CHANGELOG.md.
-// Safe to import directly in host applications and typed as stable in STABLE_API.md.
-export * from "./units.js"; // q(), SCALE, qMul, mulDiv — fixed-point arithmetic
+// This is the only import path companion projects and hosts should use:
+//   import { stepWorld, createWorld, q, SCALE } from "@its-not-rocket-science/ananke"
+//
+// Breaking changes to any export here require a major semver bump (x.0.0) and
+// a migration guide in CHANGELOG.md.  See STABLE_API.md for the full contract.
+//
+// Tier 2 (experimental) and Tier 3 (internal) exports are accessible via direct
+// module imports, e.g. import { stepAging } from ".../dist/src/sim/aging.js"
+export * from "./units.js"; // q(), SCALE, qMul, qDiv, clampQ, mulDiv, to, from, sqrtQ
 export * from "./types.js"; // IndividualAttributes, core scalar types
 export * from "./archetypes.js"; // Archetype, BodyPlan, built-in species presets
 export * from "./generate.js"; // generateIndividual()
 export * from "./equipment.js"; // WEAPONS database, EquipmentCatalogue
-export * from "./sim/vec3.js"; // Vec3, lerpVec3, addVec3 — 3-D vector helpers
+export * from "./describe.js"; // describeCharacter(), formatCharacterSheet(), formatOneLine()
+export * from "./sim/vec3.js"; // Vec3, lerpVec3, addVec3
 export * from "./sim/condition.js"; // ConditionSnapshot, condition constants
 export * from "./sim/injury.js"; // InjuryRegion, BodyRegion, injury constants
 export * from "./sim/entity.js"; // Entity (stable fields: id, pos, mass_kg, attributes…)
 export * from "./sim/commands.js"; // CommandMap, EntityCommand, action verbs
 export * from "./sim/kernel.js"; // stepWorld(), applyImpactToInjury(), applyExplosion()
 export * from "./sim/body.js"; // BodyPlan, BodySegment, humanoid / quadruped plans
-export * from "./sim/world.js"; // WorldState, KernelContext, createWorld()
-export * from "./model3d.js"; // extractRigSnapshots(), deriveAnimationHints(), RigSnapshot, AnimationHints, GrapplePoseConstraint
+export * from "./sim/world.js"; // WorldState, KernelContext
+export * from "./model3d.js"; // extractRigSnapshots(), deriveAnimationHints(), RigSnapshot, AnimationHints
 export * from "./replay.js"; // ReplayRecorder, replayTo(), serializeReplay(), deserializeReplay()
-export * from "./bridge/index.js"; // BridgeEngine, InterpolatedState, BridgeConfig — 3D renderer bridge
-// ── Tier 2 — Advanced / experimental API ─────────────────────────────────────
-// Tested and usable subsystems under active development.  May change between
-// minor versions (0.x.0); CHANGELOG.md will document any breaking change.
-// Reference STABLE_API.md §Tier 2 for the full export list per module.
-export * from "./channels.js"; // damage channel constants (BLUNT, SLASH, …)
-export * from "./traits.js"; // trait descriptors
-export * from "./derive.js"; // derived attribute helpers
-export * from "./sim/intent.js"; // IntentMap, buildIntent()
-export * from "./sim/action.js"; // ActionResult, resolveAction()
-export * from "./sim/combat.js"; // resolveHit(), resolveParry(), applyCombat()
-export * from "./quest.js"; // Quest, QuestObjective, questStep()
-export * from "./quest-generators.js"; // generateQuest(), generateQuestChain()
-export * from "./relationships.js"; // RelationshipMap, updateRelationship()
-export * from "./relationships-effects.js"; // applyRelationshipEffect()
-export * from "./inventory.js"; // Inventory, equipItem(), addItemToInventory()
-export * from "./item-durability.js"; // durability helpers, resolveRepair()
-export * from "./settlement.js"; // Settlement, stepSettlement()
-export * from "./settlement-services.js"; // service resolution helpers
-export * from "./chronicle.js"; // ChronicleEntry, addChronicleEntry()
-export * from "./story-arcs.js"; // StoryArc, detectArcs()
-export * from "./narrative-render.js"; // renderEntry(), renderChronicle(), generateNarrative()
-export * from "./world-generation.js"; // WorldTemplate, generateWorld()
-export * from "./sim/trace.js"; // SimTrace, traceStep() — debugging / profiling
-// ── Tier 3 — Internal / kernel API ───────────────────────────────────────────
-// Exported for power users and diagnostic tooling.  Not stability-guaranteed;
-// may change at any time without a changelog entry.  Prefer Tier 1/2 surfaces
-// in production host code.  See STABLE_API.md §Tier 3 for rationale.
-export * from "./rng.js"; // makeRng(), eventSeed() — RNG internals
-export * from "./dist.js"; // distribution primitives
-export * from "./lod.js"; // level-of-detail helpers
-export * from "./sim/impairment.js"; // low-level impairment accumulators
-export * from "./sim/indexing.js"; // SpatialIndex internals
-export * from "./sim/tuning.js"; // kernel tuning constants (may be adjusted)
-export * from "./sim/testing.js"; // mkHumanoidEntity() and other test helpers
+export * from "./bridge/index.js"; // BridgeEngine, InterpolatedState, BridgeConfig
 export * from "./world-factory.js"; // createWorld(), EntitySpec, ARCHETYPE_MAP, ITEM_MAP
 export * from "./scenario.js"; // loadScenario(), validateScenario(), AnankeScenario

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",