@driftengine/chemistry 3.61.0

package/dist/ignition/criteria.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Ignition is a criterion, not a flag — and extinction is four of them.
+ *
+ * **There is no `ignite()` that sets a boolean and starts a fire**, and `§11` is the argument.
+ * Ignition is what happens when the conditions for it are met, and there are five because there are
+ * five real ones. `ignite` supplies a *pilot* for one tick; holding a match to wet wood does exactly
+ * nothing, which is correct and is the API telling the truth about what a match is.
+ *
+ * **The mass flux is the real criterion and the temperature is the cheap proxy.** Ignition happens
+ * when enough fuel is coming off the surface to make a flammable mixture above it; the surface
+ * temperature is a correlate of that rather than a cause. Both are kept, because the temperature is
+ * what a consumer reads in an interface — *this is getting hot* — and the flux is what decides.
+ */
+export interface IgnitionModel {
+    /** K at which a surface will catch **given a pilot**. Wood: 623. */
+    readonly pilotedSurfaceK: number;
+    /** K at which it catches with no pilot at all. Wood: 773, and the gap is why a spark matters. */
+    readonly autoSurfaceK: number;
+    /** kg/(m²·s) of volatiles leaving the surface. Wood: about 0.0035, or 3.5 g/m²·s. */
+    readonly criticalMassFlux: number;
+    /** Volume fraction below which a flame cannot be sustained. About 0.14 for most solids. */
+    readonly limitingOxygen?: number;
+    /** And below which even a smoulder cannot. Far lower — about 0.05 — which is why smothering leaves embers. */
+    readonly smoulderingOxygen?: number;
+    /** Volume fractions between which this material's volatiles carry a flame. */
+    readonly lowerFlammable?: number;
+    readonly upperFlammable?: number;
+}
+export declare const DEFAULT_LIMITING_OXYGEN = 0.14;
+export declare const DEFAULT_SMOULDERING_OXYGEN = 0.05;
+/** m/s of local gas past a surface, beyond which a flame cannot anchor and is blown off. */
+export declare const BLOW_OFF_SPEED = 8;
+/**
+ * How close a parcel is to catching, 0 to 1.
+ *
+ * The **minimum** of the five criteria's individual satisfactions, so it reads as "the nearest
+ * thing to ready that everything is". A readout rather than a state: nothing branches on it, and a
+ * consumer wanting a *this is about to catch* indicator reads one number instead of five.
+ */
+export declare function ignitionProgress(model: IgnitionModel, surfaceTemperature: number, fuelFlux: number, oxygenFraction: number, piloted: boolean): number;
+/**
+ * The fuel fraction **at the surface**, which is not the fuel fraction in the room.
+ *
+ * A flame sits in a boundary layer a few millimetres thick, and a cell in this model is a cubic
+ * metre. Reading a cell average and calling it the mixture over a surface is a resolution error,
+ * and it is one this phase made and measured: a log at 1,063 K pouring off nearly a kilogram per
+ * square metre per second registered 1.7% combustible gas in the cell around it and never caught,
+ * because the flame was being asked to burn the room rather than the boundary layer.
+ *
+ * What is right is the fuel's share of everything leaving the surface plus everything sweeping past:
+ *
+ *     C ≈ ṁ_fuel / (ṁ_total + v·ρ)
+ *
+ * so a strong flux is rich, a weak one is lean, and a wind thins it — the same mechanism that blows
+ * a flame off, arriving here too and for the same reason.
+ *
+ * **The two fluxes are separate, and that is what a green log turns on.** `§21`: steam leaving a wet
+ * surface dilutes the gas above it, so even once volatiles appear the mixture is below its lower
+ * limit. With one flux standing in for both, water vapour counted as fuel and a log at 60% moisture
+ * caught in front of a campfire — which it does not, and which this test said before this line
+ * existed.
+ */
+export declare function surfaceFuelFraction(fuelFlux: number, totalFlux: number, gasSpeed: number): number;
+/**
+ * Whether all five conditions for flaming ignition hold.
+ *
+ * Surface hot enough, enough fuel coming off it, oxygen above the limiting index, the mixture **at
+ * the surface** within its flammability limits, and — for the lower of the two temperatures — a
+ * pilot.
+ */
+export declare function ignites(model: IgnitionModel, surfaceTemperature: number, fuelFlux: number, totalFlux: number, oxygenFraction: number, gasSpeed: number, piloted: boolean): boolean;
+/** Volume fractions between which a lumped volatile mixture will carry a flame. */
+export declare const DEFAULT_LOWER_FLAMMABLE = 0.03;
+export declare const DEFAULT_UPPER_FLAMMABLE = 0.95;
+/** Why a flame went out, or `-1` where it did not. The order is the order they are checked in. */
+export declare const EXTINCT_NONE = -1;
+export declare const EXTINCT_FUEL = 0;
+export declare const EXTINCT_OXYGEN = 1;
+export declare const EXTINCT_COOLED = 2;
+export declare const EXTINCT_BLOWN_OFF = 3;
+/**
+ * Whether a flame stops, and which of the four reasons it was.
+ *
+ * **Blow-off is the one that reads oddly and is right.** Blowing on a candle puts it out because
+ * the gas moves faster than the flame can propagate back into it; blowing on embers makes them
+ * brighter, because there is no flame to blow off and more oxygen arrives. Both come out of this
+ * function returning a reason for one and not for the other.
+ */
+export declare function extinguishes(model: IgnitionModel, fuelFlux: number, oxygenFraction: number, surfaceTemperature: number, gasSpeed: number): number;
+/**
+ * Whether a smoulder can persist: char present, and oxygen above the far lower index it needs.
+ *
+ * A smoulder needs no flammable mixture and no pilot, because there is no gas-phase flame at all —
+ * oxygen meets solid carbon at the surface. That is why it survives conditions a flame cannot, and
+ * why it is the half of a fire that reignites a room after the flames are out.
+ */
+export declare function smoulders(model: IgnitionModel, charFraction: number, oxygenFraction: number, surfaceTemperature: number): boolean;

package/dist/ignition/criteria.js

@@ -0,0 +1,135 @@
+/**
+ * Ignition is a criterion, not a flag — and extinction is four of them.
+ *
+ * **There is no `ignite()` that sets a boolean and starts a fire**, and `§11` is the argument.
+ * Ignition is what happens when the conditions for it are met, and there are five because there are
+ * five real ones. `ignite` supplies a *pilot* for one tick; holding a match to wet wood does exactly
+ * nothing, which is correct and is the API telling the truth about what a match is.
+ *
+ * **The mass flux is the real criterion and the temperature is the cheap proxy.** Ignition happens
+ * when enough fuel is coming off the surface to make a flammable mixture above it; the surface
+ * temperature is a correlate of that rather than a cause. Both are kept, because the temperature is
+ * what a consumer reads in an interface — *this is getting hot* — and the flux is what decides.
+ */
+export const DEFAULT_LIMITING_OXYGEN = 0.14;
+export const DEFAULT_SMOULDERING_OXYGEN = 0.05;
+/** m/s of local gas past a surface, beyond which a flame cannot anchor and is blown off. */
+export const BLOW_OFF_SPEED = 8;
+/**
+ * How close a parcel is to catching, 0 to 1.
+ *
+ * The **minimum** of the five criteria's individual satisfactions, so it reads as "the nearest
+ * thing to ready that everything is". A readout rather than a state: nothing branches on it, and a
+ * consumer wanting a *this is about to catch* indicator reads one number instead of five.
+ */
+export function ignitionProgress(model, surfaceTemperature, fuelFlux, oxygenFraction, piloted) {
+    const threshold = piloted ? model.pilotedSurfaceK : model.autoSurfaceK;
+    const limiting = model.limitingOxygen ?? DEFAULT_LIMITING_OXYGEN;
+    const heat = ratio(surfaceTemperature - 293.15, threshold - 293.15);
+    const fuel = ratio(fuelFlux, model.criticalMassFlux);
+    const air = ratio(oxygenFraction, limiting);
+    const smallest = Math.min(heat, fuel, air);
+    return smallest < 0 ? 0 : smallest > 1 ? 1 : smallest;
+}
+function ratio(value, against) {
+    if (!(against > 0))
+        return value > 0 ? 1 : 0;
+    return value / against;
+}
+/**
+ * The fuel fraction **at the surface**, which is not the fuel fraction in the room.
+ *
+ * A flame sits in a boundary layer a few millimetres thick, and a cell in this model is a cubic
+ * metre. Reading a cell average and calling it the mixture over a surface is a resolution error,
+ * and it is one this phase made and measured: a log at 1,063 K pouring off nearly a kilogram per
+ * square metre per second registered 1.7% combustible gas in the cell around it and never caught,
+ * because the flame was being asked to burn the room rather than the boundary layer.
+ *
+ * What is right is the fuel's share of everything leaving the surface plus everything sweeping past:
+ *
+ *     C ≈ ṁ_fuel / (ṁ_total + v·ρ)
+ *
+ * so a strong flux is rich, a weak one is lean, and a wind thins it — the same mechanism that blows
+ * a flame off, arriving here too and for the same reason.
+ *
+ * **The two fluxes are separate, and that is what a green log turns on.** `§21`: steam leaving a wet
+ * surface dilutes the gas above it, so even once volatiles appear the mixture is below its lower
+ * limit. With one flux standing in for both, water vapour counted as fuel and a log at 60% moisture
+ * caught in front of a campfire — which it does not, and which this test said before this line
+ * existed.
+ */
+export function surfaceFuelFraction(fuelFlux, totalFlux, gasSpeed) {
+    const sweep = (TRANSFER_VELOCITY + gasSpeed) * AIR_DENSITY;
+    const total = totalFlux + sweep;
+    return total > 0 ? fuelFlux / total : 0;
+}
+/** m/s of natural mass transfer past a surface in still air. */
+const TRANSFER_VELOCITY = 0.02;
+/** kg/m³. */
+const AIR_DENSITY = 1.2;
+/**
+ * Whether all five conditions for flaming ignition hold.
+ *
+ * Surface hot enough, enough fuel coming off it, oxygen above the limiting index, the mixture **at
+ * the surface** within its flammability limits, and — for the lower of the two temperatures — a
+ * pilot.
+ */
+export function ignites(model, surfaceTemperature, fuelFlux, totalFlux, oxygenFraction, gasSpeed, piloted) {
+    const threshold = piloted ? model.pilotedSurfaceK : model.autoSurfaceK;
+    if (surfaceTemperature < threshold)
+        return false;
+    /* The critical mass flux is a flux of **fuel**, which is what the measured figure means. */
+    if (fuelFlux < model.criticalMassFlux)
+        return false;
+    if (oxygenFraction < (model.limitingOxygen ?? DEFAULT_LIMITING_OXYGEN))
+        return false;
+    const mixture = surfaceFuelFraction(fuelFlux, totalFlux, gasSpeed);
+    if (mixture < (model.lowerFlammable ?? DEFAULT_LOWER_FLAMMABLE))
+        return false;
+    if (mixture > (model.upperFlammable ?? DEFAULT_UPPER_FLAMMABLE))
+        return false;
+    return true;
+}
+/** Volume fractions between which a lumped volatile mixture will carry a flame. */
+export const DEFAULT_LOWER_FLAMMABLE = 0.03;
+export const DEFAULT_UPPER_FLAMMABLE = 0.95;
+/** Why a flame went out, or `-1` where it did not. The order is the order they are checked in. */
+export const EXTINCT_NONE = -1;
+export const EXTINCT_FUEL = 0;
+export const EXTINCT_OXYGEN = 1;
+export const EXTINCT_COOLED = 2;
+export const EXTINCT_BLOWN_OFF = 3;
+/**
+ * Whether a flame stops, and which of the four reasons it was.
+ *
+ * **Blow-off is the one that reads oddly and is right.** Blowing on a candle puts it out because
+ * the gas moves faster than the flame can propagate back into it; blowing on embers makes them
+ * brighter, because there is no flame to blow off and more oxygen arrives. Both come out of this
+ * function returning a reason for one and not for the other.
+ */
+export function extinguishes(model, fuelFlux, oxygenFraction, surfaceTemperature, gasSpeed) {
+    if (fuelFlux < model.criticalMassFlux)
+        return EXTINCT_FUEL;
+    if (oxygenFraction < (model.limitingOxygen ?? DEFAULT_LIMITING_OXYGEN))
+        return EXTINCT_OXYGEN;
+    /* A surface below its own piloted ignition point is no longer feeding a flame it could relight. */
+    if (surfaceTemperature < model.pilotedSurfaceK)
+        return EXTINCT_COOLED;
+    if (gasSpeed > BLOW_OFF_SPEED)
+        return EXTINCT_BLOWN_OFF;
+    return EXTINCT_NONE;
+}
+/**
+ * Whether a smoulder can persist: char present, and oxygen above the far lower index it needs.
+ *
+ * A smoulder needs no flammable mixture and no pilot, because there is no gas-phase flame at all —
+ * oxygen meets solid carbon at the surface. That is why it survives conditions a flame cannot, and
+ * why it is the half of a fire that reignites a room after the flames are out.
+ */
+export function smoulders(model, charFraction, oxygenFraction, surfaceTemperature) {
+    if (!(charFraction > 0))
+        return false;
+    if (oxygenFraction < (model.smoulderingOxygen ?? DEFAULT_SMOULDERING_OXYGEN))
+        return false;
+    return surfaceTemperature > 600;
+}

package/dist/ignition/events.d.ts

@@ -0,0 +1,56 @@
+/**
+ * What happened this tick, as a buffer a caller drains.
+ *
+ * The shape `drift/physics`'s contact buffer established, and for the reason that one exists: a
+ * stream a consumer polls is allocation-free, and a callback per event is not. Cleared at the top
+ * of every tick, so an event not read this frame is gone — which is the same contract contacts have
+ * and the same one a consumer already knows.
+ *
+ * **The kinds are closed.** A consumer that wants a distinction this list does not draw reads the
+ * numbers instead; adding a kind is a decision about what the model claims to notice.
+ */
+export declare const EVENT_IGNITED = 0;
+export declare const EVENT_EXTINGUISHED = 1;
+export declare const EVENT_SMOULDER_START = 2;
+export declare const EVENT_SMOULDER_END = 3;
+export declare const EVENT_CONSUMED = 4;
+export declare const EVENT_CHARRED = 5;
+export declare const EVENT_STRUCTURAL_FAIL = 6;
+export declare const EVENT_FROZEN = 7;
+export declare const EVENT_MELTED = 8;
+export declare const EVENT_BOILED = 9;
+export declare const EVENT_CONDENSED = 10;
+export declare const EVENT_SUBLIMED = 11;
+export declare const EVENT_CORRODED = 12;
+export declare const EVENT_CALCINED = 13;
+export declare const EVENT_DISSOLVED = 14;
+export declare const EVENT_DENATURED = 15;
+export declare const EVENT_BROWNED = 16;
+export declare const EVENT_CARAMELISED = 17;
+export declare const EVENT_FERMENTED = 18;
+export declare const EVENT_DECAYED = 19;
+/**
+ * A confined deflagration crossed a pressure threshold.
+ *
+ * `§26` refuses detonation in writing: a supersonic shock front is a physics problem in a package
+ * that owns no solver. This is the refusal **reporting** rather than simulating — the event says a
+ * pressure was exceeded and where, and the consumer decides what a wall does about it.
+ */
+export declare const EVENT_EXPLODED = 20;
+export declare const EVENT_KIND_COUNT = 21;
+export declare class ChemistryEvents {
+    private kind;
+    private parcel;
+    private species;
+    private value;
+    private used;
+    get count(): number;
+    clear(): void;
+    /** @param species `-1` where the kind does not name one. @param value the kind's own quantity. */
+    push(kind: number, parcel: number, species: number, value: number): void;
+    kindOf(event: number): number;
+    parcelOf(event: number): number;
+    speciesOf(event: number): number;
+    valueOf(event: number): number;
+    private grow;
+}

package/dist/ignition/events.js

@@ -0,0 +1,90 @@
+/**
+ * What happened this tick, as a buffer a caller drains.
+ *
+ * The shape `drift/physics`'s contact buffer established, and for the reason that one exists: a
+ * stream a consumer polls is allocation-free, and a callback per event is not. Cleared at the top
+ * of every tick, so an event not read this frame is gone — which is the same contract contacts have
+ * and the same one a consumer already knows.
+ *
+ * **The kinds are closed.** A consumer that wants a distinction this list does not draw reads the
+ * numbers instead; adding a kind is a decision about what the model claims to notice.
+ */
+export const EVENT_IGNITED = 0;
+export const EVENT_EXTINGUISHED = 1;
+export const EVENT_SMOULDER_START = 2;
+export const EVENT_SMOULDER_END = 3;
+export const EVENT_CONSUMED = 4;
+export const EVENT_CHARRED = 5;
+export const EVENT_STRUCTURAL_FAIL = 6;
+export const EVENT_FROZEN = 7;
+export const EVENT_MELTED = 8;
+export const EVENT_BOILED = 9;
+export const EVENT_CONDENSED = 10;
+export const EVENT_SUBLIMED = 11;
+export const EVENT_CORRODED = 12;
+export const EVENT_CALCINED = 13;
+export const EVENT_DISSOLVED = 14;
+export const EVENT_DENATURED = 15;
+export const EVENT_BROWNED = 16;
+export const EVENT_CARAMELISED = 17;
+export const EVENT_FERMENTED = 18;
+export const EVENT_DECAYED = 19;
+/**
+ * A confined deflagration crossed a pressure threshold.
+ *
+ * `§26` refuses detonation in writing: a supersonic shock front is a physics problem in a package
+ * that owns no solver. This is the refusal **reporting** rather than simulating — the event says a
+ * pressure was exceeded and where, and the consumer decides what a wall does about it.
+ */
+export const EVENT_EXPLODED = 20;
+export const EVENT_KIND_COUNT = 21;
+export class ChemistryEvents {
+    kind = new Int32Array(64);
+    parcel = new Int32Array(64);
+    species = new Int32Array(64);
+    value = new Float64Array(64);
+    used = 0;
+    get count() {
+        return this.used;
+    }
+    clear() {
+        this.used = 0;
+    }
+    /** @param species `-1` where the kind does not name one. @param value the kind's own quantity. */
+    push(kind, parcel, species, value) {
+        if (this.used === this.kind.length)
+            this.grow();
+        const at = this.used++;
+        this.kind[at] = kind;
+        this.parcel[at] = parcel;
+        this.species[at] = species;
+        this.value[at] = value;
+    }
+    kindOf(event) {
+        return this.kind[event];
+    }
+    parcelOf(event) {
+        return this.parcel[event];
+    }
+    speciesOf(event) {
+        return this.species[event];
+    }
+    valueOf(event) {
+        return this.value[event];
+    }
+    grow() {
+        const size = this.kind.length * 2;
+        const kind = new Int32Array(size);
+        kind.set(this.kind);
+        this.kind = kind;
+        const parcel = new Int32Array(size);
+        parcel.set(this.parcel);
+        this.parcel = parcel;
+        const species = new Int32Array(size);
+        species.set(this.species);
+        this.species = species;
+        const value = new Float64Array(size);
+        value.set(this.value);
+        this.value = value;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+/*! DriftEngine | Copyright 2026 Drift Technologies | Apache-2.0 | https://github.com/drftrun/driftengine */
+/**
+ * `@driftengine/chemistry` — thermochemistry of bulk matter.
+ *
+ * Game code imports from `@driftengine/chemistry` only; nothing reaches inside. This package
+ * **imports no other engine package**, which is the property `@driftengine/physics` and
+ * `@driftengine/entities` have and the reason all three were affordable: everything it needs from
+ * the rest of the engine arrives as plain data or through a structural target.
+ *
+ * **CH-0 through CH-7 of Track P.** CH-0 is the ledger: the closed element set, the species registry
+ * whose molar masses are derived from formulas, the species-by-element matrix, mass-fraction
+ * compositions, and the reduction that turns kilograms of species into moles of elements. CH-1 is
+ * the state: **enthalpy rather than temperature**, a curve per substance whose flat regions are the
+ * phase changes, boiling against pressure, and a parcel store. CH-2 is the depth: nested shells of
+ * equal mass and inward conduction, which is what makes a twig catch and a log not. CH-3 is the
+ * network: reactions balanced against the element matrix at registration, enthalpies derived by
+ * Hess's law, rates tabulated so `exp` never runs on a tick, and a substep-and-clamp solver that
+ * cannot produce a negative mass. CH-4 is the air: one sparse atmosphere carrying oxygen to a fire
+ * and smoke away from it, with conservative flux-form transport, buoyancy, the one wind, and a
+ * connectivity that makes a sealed room genuinely sealed. CH-5 joins them: radiation with the
+ * `1/r²` that makes "near the fire" mean something, convection, contact conduction, and the
+ * exchange that lets a burning parcel eat the oxygen around it and push its smoke into the air.
+ *
+ * CH-6 retired the enthalpy curve: the latent heat was already in the formation enthalpies, so a
+ * phase change is a gated reaction and its plateau emerges from the solver. Ignition became five
+ * criteria rather than a flag. **CH-7 is the substances**, and they are not here: thirty-nine of
+ * them across seven entry points under `library/*`, because a substance is forty numbers and a
+ * composition, and a consumer who wants a campfire should not pay for polyurethane. What this
+ * barrel exports of CH-7 is `installLibrary` and nothing else.
+ *
+ * That shape is deliberate. `elementTotals` is the assertion every later phase is checked with, and
+ * it exists before there is anything to conserve through, so the day a reaction first moves matter
+ * there is already a test that says whether it moved the right amount.
+ *
+ * The design is recorded in this package's README.
+ */
+export type { ElementSymbol } from './element/elements.ts';
+export { ATOMIC_MASS, ELEMENTS, ELEMENT_COUNT, elementIndex } from './element/elements.ts';
+export { SpeciesElementMatrix } from './element/matrix.ts';
+export type { Phase, SpeciesDefinition } from './species/species.ts';
+export { PHASE_GAS, PHASE_LIQUID, PHASE_SOLID, STANDARD_PRESSURE, STANDARD_TEMPERATURE, } from './species/species.ts';
+export { SpeciesRegistry } from './species/registry.ts';
+export { STANDARD_SPECIES, registerStandardSpecies } from './species/standard.ts';
+export type { Composition } from './substance/composition.ts';
+export { SUM_TOLERANCE, massFractions } from './substance/composition.ts';
+export type { AppearanceModel, SubstanceThermal } from './substance/substance.ts';
+export { compositionElements, wetComposition } from './substance/substance.ts';
+export { MAX_MODEL_TEMPERATURE, MIN_MODEL_TEMPERATURE, sensibleEnthalpy, temperatureFromCapacity, } from './species/thermal.ts';
+export { boilingPoint } from './substance/boiling.ts';
+export { SubstanceRegistry } from './substance/registry.ts';
+export type { Shape, ShellGeometry } from './parcel/shells.ts';
+export { MAX_SHELLS, SHAPE_CYLINDER, SHAPE_SLAB, SHAPE_SPHERE, shellGeometry, } from './parcel/shells.ts';
+export type { ConductionModel, Conductivity } from './parcel/conduction.ts';
+export { conductShells } from './parcel/conduction.ts';
+export type { ParcelSpec } from './parcel/store.ts';
+export { PHASE_MIXED, ParcelStore } from './parcel/store.ts';
+export type { Tier } from './parcel/tier.ts';
+export { TIER_CADENCE, TIER_COUNT, TIER_DISTANT, TIER_FAR, TIER_HERO, TIER_NEAR, TIER_SHELLS, TIER_SUBSTEPS, } from './parcel/tier.ts';
+export { fingerprintChemistry } from './world/fingerprint.ts';
+export type { ArrheniusKinetics, CardinalKinetics, DiffusionKinetics, InstantKinetics, Kinetics, Reaction, ReactionKind, SpeciesAmount, } from './reaction/reaction.ts';
+export type { ReactionGates } from './reaction/reaction.ts';
+export { KIND_BIOLOGICAL, KIND_BROWNING, KIND_CALCINATION, KIND_CHAR_OXIDATION, KIND_COMBUSTION, KIND_CORROSION, KIND_DENATURATION, KIND_DISSOLUTION, KIND_DRYING, KIND_PHASE_CHANGE, KIND_PYROLYSIS, phaseChange, } from './reaction/reaction.ts';
+export { ReactionRegistry } from './reaction/registry.ts';
+export type { RateTable } from './reaction/rates.ts';
+export { GAS_CONSTANT, cardinalRate, rateAt, tabulateArrhenius, tabulateCardinal, } from './reaction/rates.ts';
+export type { SubstanceReactions } from './reaction/solver.ts';
+export { MAX_SUBSTANCE_REACTIONS, MAX_SUBSTANCE_SPECIES, reactShell } from './reaction/solver.ts';
+export type { AmbientState } from './field/ambient.ts';
+export { STANDARD_AIR, STANDARD_FIELD_SPECIES, STANDARD_PRESSURE_PA, ambientCellMass, saturationVapourPressure, } from './field/ambient.ts';
+export type { AtmosphereOptions } from './field/atmosphere.ts';
+export { AtmosphereField, CHUNK_CELLS, CHUNK_SIZE } from './field/atmosphere.ts';
+export { localiseReactions } from './reaction/localise.ts';
+export type { OcclusionTest } from './transport/radiation.ts';
+export { RadiativeSources, STEFAN_BOLTZMANN, convectiveCoefficient, radiantFlux, sourceRange, } from './transport/radiation.ts';
+export { ContactSet } from './transport/contacts.ts';
+export type { IgnitionModel } from './ignition/criteria.ts';
+export { BLOW_OFF_SPEED, DEFAULT_LIMITING_OXYGEN, DEFAULT_LOWER_FLAMMABLE, DEFAULT_SMOULDERING_OXYGEN, DEFAULT_UPPER_FLAMMABLE, surfaceFuelFraction, EXTINCT_BLOWN_OFF, EXTINCT_COOLED, EXTINCT_FUEL, EXTINCT_NONE, EXTINCT_OXYGEN, extinguishes, ignitionProgress, ignites, smoulders, } from './ignition/criteria.ts';
+export { ChemistryEvents, EVENT_BOILED, EVENT_BROWNED, EVENT_CALCINED, EVENT_CARAMELISED, EVENT_CHARRED, EVENT_CONDENSED, EVENT_CONSUMED, EVENT_CORRODED, EVENT_DECAYED, EVENT_DENATURED, EVENT_DISSOLVED, EVENT_EXPLODED, EVENT_EXTINGUISHED, EVENT_FERMENTED, EVENT_FROZEN, EVENT_IGNITED, EVENT_KIND_COUNT, EVENT_MELTED, EVENT_SMOULDER_END, EVENT_SMOULDER_START, EVENT_STRUCTURAL_FAIL, EVENT_SUBLIMED, } from './ignition/events.ts';
+export type { ChemistryWorldOptions } from './transport/world.ts';
+export { ChemistryWorld } from './transport/world.ts';
+export { elementTotals } from './conservation.ts';
+export type { SubstanceLibrary } from './library/library.ts';
+export { installLibrary } from './library/library.ts';
+export { maxElementDrift } from './testing/drift.ts';

package/dist/index.js

@@ -0,0 +1,66 @@
+/*! DriftEngine | Copyright 2026 Drift Technologies | Apache-2.0 | https://github.com/drftrun/driftengine */
+/**
+ * `@driftengine/chemistry` — thermochemistry of bulk matter.
+ *
+ * Game code imports from `@driftengine/chemistry` only; nothing reaches inside. This package
+ * **imports no other engine package**, which is the property `@driftengine/physics` and
+ * `@driftengine/entities` have and the reason all three were affordable: everything it needs from
+ * the rest of the engine arrives as plain data or through a structural target.
+ *
+ * **CH-0 through CH-7 of Track P.** CH-0 is the ledger: the closed element set, the species registry
+ * whose molar masses are derived from formulas, the species-by-element matrix, mass-fraction
+ * compositions, and the reduction that turns kilograms of species into moles of elements. CH-1 is
+ * the state: **enthalpy rather than temperature**, a curve per substance whose flat regions are the
+ * phase changes, boiling against pressure, and a parcel store. CH-2 is the depth: nested shells of
+ * equal mass and inward conduction, which is what makes a twig catch and a log not. CH-3 is the
+ * network: reactions balanced against the element matrix at registration, enthalpies derived by
+ * Hess's law, rates tabulated so `exp` never runs on a tick, and a substep-and-clamp solver that
+ * cannot produce a negative mass. CH-4 is the air: one sparse atmosphere carrying oxygen to a fire
+ * and smoke away from it, with conservative flux-form transport, buoyancy, the one wind, and a
+ * connectivity that makes a sealed room genuinely sealed. CH-5 joins them: radiation with the
+ * `1/r²` that makes "near the fire" mean something, convection, contact conduction, and the
+ * exchange that lets a burning parcel eat the oxygen around it and push its smoke into the air.
+ *
+ * CH-6 retired the enthalpy curve: the latent heat was already in the formation enthalpies, so a
+ * phase change is a gated reaction and its plateau emerges from the solver. Ignition became five
+ * criteria rather than a flag. **CH-7 is the substances**, and they are not here: thirty-nine of
+ * them across seven entry points under `library/*`, because a substance is forty numbers and a
+ * composition, and a consumer who wants a campfire should not pay for polyurethane. What this
+ * barrel exports of CH-7 is `installLibrary` and nothing else.
+ *
+ * That shape is deliberate. `elementTotals` is the assertion every later phase is checked with, and
+ * it exists before there is anything to conserve through, so the day a reaction first moves matter
+ * there is already a test that says whether it moved the right amount.
+ *
+ * The design is recorded in this package's README.
+ */
+export { ATOMIC_MASS, ELEMENTS, ELEMENT_COUNT, elementIndex } from './element/elements.js';
+export { SpeciesElementMatrix } from './element/matrix.js';
+export { PHASE_GAS, PHASE_LIQUID, PHASE_SOLID, STANDARD_PRESSURE, STANDARD_TEMPERATURE, } from './species/species.js';
+export { SpeciesRegistry } from './species/registry.js';
+export { STANDARD_SPECIES, registerStandardSpecies } from './species/standard.js';
+export { SUM_TOLERANCE, massFractions } from './substance/composition.js';
+export { compositionElements, wetComposition } from './substance/substance.js';
+export { MAX_MODEL_TEMPERATURE, MIN_MODEL_TEMPERATURE, sensibleEnthalpy, temperatureFromCapacity, } from './species/thermal.js';
+export { boilingPoint } from './substance/boiling.js';
+export { SubstanceRegistry } from './substance/registry.js';
+export { MAX_SHELLS, SHAPE_CYLINDER, SHAPE_SLAB, SHAPE_SPHERE, shellGeometry, } from './parcel/shells.js';
+export { conductShells } from './parcel/conduction.js';
+export { PHASE_MIXED, ParcelStore } from './parcel/store.js';
+export { TIER_CADENCE, TIER_COUNT, TIER_DISTANT, TIER_FAR, TIER_HERO, TIER_NEAR, TIER_SHELLS, TIER_SUBSTEPS, } from './parcel/tier.js';
+export { fingerprintChemistry } from './world/fingerprint.js';
+export { KIND_BIOLOGICAL, KIND_BROWNING, KIND_CALCINATION, KIND_CHAR_OXIDATION, KIND_COMBUSTION, KIND_CORROSION, KIND_DENATURATION, KIND_DISSOLUTION, KIND_DRYING, KIND_PHASE_CHANGE, KIND_PYROLYSIS, phaseChange, } from './reaction/reaction.js';
+export { ReactionRegistry } from './reaction/registry.js';
+export { GAS_CONSTANT, cardinalRate, rateAt, tabulateArrhenius, tabulateCardinal, } from './reaction/rates.js';
+export { MAX_SUBSTANCE_REACTIONS, MAX_SUBSTANCE_SPECIES, reactShell } from './reaction/solver.js';
+export { STANDARD_AIR, STANDARD_FIELD_SPECIES, STANDARD_PRESSURE_PA, ambientCellMass, saturationVapourPressure, } from './field/ambient.js';
+export { AtmosphereField, CHUNK_CELLS, CHUNK_SIZE } from './field/atmosphere.js';
+export { localiseReactions } from './reaction/localise.js';
+export { RadiativeSources, STEFAN_BOLTZMANN, convectiveCoefficient, radiantFlux, sourceRange, } from './transport/radiation.js';
+export { ContactSet } from './transport/contacts.js';
+export { BLOW_OFF_SPEED, DEFAULT_LIMITING_OXYGEN, DEFAULT_LOWER_FLAMMABLE, DEFAULT_SMOULDERING_OXYGEN, DEFAULT_UPPER_FLAMMABLE, surfaceFuelFraction, EXTINCT_BLOWN_OFF, EXTINCT_COOLED, EXTINCT_FUEL, EXTINCT_NONE, EXTINCT_OXYGEN, extinguishes, ignitionProgress, ignites, smoulders, } from './ignition/criteria.js';
+export { ChemistryEvents, EVENT_BOILED, EVENT_BROWNED, EVENT_CALCINED, EVENT_CARAMELISED, EVENT_CHARRED, EVENT_CONDENSED, EVENT_CONSUMED, EVENT_CORRODED, EVENT_DECAYED, EVENT_DENATURED, EVENT_DISSOLVED, EVENT_EXPLODED, EVENT_EXTINGUISHED, EVENT_FERMENTED, EVENT_FROZEN, EVENT_IGNITED, EVENT_KIND_COUNT, EVENT_MELTED, EVENT_SMOULDER_END, EVENT_SMOULDER_START, EVENT_STRUCTURAL_FAIL, EVENT_SUBLIMED, } from './ignition/events.js';
+export { ChemistryWorld } from './transport/world.js';
+export { elementTotals } from './conservation.js';
+export { installLibrary } from './library/library.js';
+export { maxElementDrift } from './testing/drift.js';

package/dist/library/biological.d.ts

@@ -0,0 +1,6 @@
+import type { SubstanceLibrary } from './library.ts';
+export declare const DECAY_MESOPHILIC = "decay-mesophilic";
+export declare const DECAY_THERMOPHILIC = "decay-thermophilic";
+export declare const DECAY_ANAEROBIC = "decay-anaerobic";
+export declare const FERMENT = "ferment";
+export declare const BIOLOGICAL: SubstanceLibrary;