@twilite-app/world-gen-engine 0.0.0-stage → 0.1.0

package/dist/coordinateHash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns a stable unsigned 32-bit hash for a seed, stable node id, and world cell.
+ * The hash uses UTF-16 code units and length-framed string fields.
+ */
+export declare function hashCoordinate(seed: string, nodeId: string, x: number, y: number): number;
+export declare function coordinateUnit(seed: string, nodeId: string, x: number, y: number): number;
+//# sourceMappingURL=coordinateHash.d.ts.map

package/dist/coordinateHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinateHash.d.ts","sourceRoot":"","sources":["../src/coordinateHash.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBzF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzF"}

package/dist/coordinateHash.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashCoordinate = hashCoordinate;
+exports.coordinateUnit = coordinateUnit;
+const FNV_OFFSET_BASIS = 0x811c9dc5;
+const FNV_PRIME = 0x01000193;
+const HASH_DOMAIN = 'twilite.worldgen.coordinate.v1';
+function hashString(state, value) {
+    let hash = state;
+    hash = Math.imul(hash ^ value.length, FNV_PRIME);
+    for (let index = 0; index < value.length; index += 1) {
+        hash = Math.imul(hash ^ value.charCodeAt(index), FNV_PRIME);
+    }
+    return hash >>> 0;
+}
+function assertCoordinate(name, value) {
+    if (!Number.isSafeInteger(value) || Object.is(value, -0)) {
+        throw new RangeError(`${name} must be a safe integer and cannot be -0`);
+    }
+}
+/**
+ * Returns a stable unsigned 32-bit hash for a seed, stable node id, and world cell.
+ * The hash uses UTF-16 code units and length-framed string fields.
+ */
+function hashCoordinate(seed, nodeId, x, y) {
+    if (seed.length === 0) {
+        throw new TypeError('seed must not be empty');
+    }
+    if (nodeId.length === 0) {
+        throw new TypeError('nodeId must not be empty');
+    }
+    assertCoordinate('x', x);
+    assertCoordinate('y', y);
+    let hash = hashString(FNV_OFFSET_BASIS, HASH_DOMAIN);
+    hash = hashString(hash, seed);
+    hash = hashString(hash, nodeId);
+    hash = hashString(hash, String(x));
+    hash = hashString(hash, String(y));
+    return hash >>> 0;
+}
+function coordinateUnit(seed, nodeId, x, y) {
+    return hashCoordinate(seed, nodeId, x, y) / 0x1_0000_0000;
+}
+//# sourceMappingURL=coordinateHash.js.map

package/dist/coordinateHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinateHash.js","sourceRoot":"","sources":["../src/coordinateHash.ts"],"names":[],"mappings":";;AAyBA,wCAgBC;AAED,wCAEC;AA7CD,MAAM,gBAAgB,GAAG,UAAU,CAAC;AACpC,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAErD,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa;IAC9C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAAa;IACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,0CAA0C,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAY,EAAE,MAAc,EAAE,CAAS,EAAE,CAAS;IAC/E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAClD,CAAC;IACD,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACzB,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEzB,IAAI,IAAI,GAAG,UAAU,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY,EAAE,MAAc,EAAE,CAAS,EAAE,CAAS;IAC/E,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC;AAC5D,CAAC"}

package/dist/dualGrid.d.ts

@@ -0,0 +1,2 @@
+export declare function dualGridMask(northwest: boolean, northeast: boolean, southwest: boolean, southeast: boolean): number;
+//# sourceMappingURL=dualGrid.d.ts.map

package/dist/dualGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dualGrid.d.ts","sourceRoot":"","sources":["../src/dualGrid.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,CAOR"}

package/dist/dualGrid.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dualGridMask = dualGridMask;
+function dualGridMask(northwest, northeast, southwest, southeast) {
+    return (Number(northwest) |
+        (Number(northeast) << 1) |
+        (Number(southwest) << 2) |
+        (Number(southeast) << 3));
+}
+//# sourceMappingURL=dualGrid.js.map

package/dist/dualGrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dualGrid.js","sourceRoot":"","sources":["../src/dualGrid.ts"],"names":[],"mappings":";;AAAA,oCAYC;AAZD,SAAgB,YAAY,CAC1B,SAAkB,EAClB,SAAkB,EAClB,SAAkB,EAClB,SAAkB;IAElB,OAAO,CACL,MAAM,CAAC,SAAS,CAAC;QACjB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CACzB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { coordinateUnit, hashCoordinate } from './coordinateHash';
+export { dualGridMask } from './dualGrid';
+export type { PathNoisePreset, PathNoiseSettings, VerticalChunk, VerticalChunkRequest, VerticalWorldRecipe, } from './verticalWorld';
+export { DEFAULT_CHUNK_HEIGHT, DEFAULT_CHUNK_WIDTH, DEFAULT_PATH_NOISE, generateVerticalChunk, MAX_CHUNK_HEIGHT, MAX_CHUNK_WIDTH, MAX_WORLD_SEED, MIN_CHUNK_HEIGHT, MIN_CHUNK_WIDTH, resolvePathNoiseSettings, } from './verticalWorld';
+export declare const WORLD_GEN_ENGINE_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,wBAAwB,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORLD_GEN_ENGINE_VERSION = exports.resolvePathNoiseSettings = exports.MIN_CHUNK_WIDTH = exports.MIN_CHUNK_HEIGHT = exports.MAX_WORLD_SEED = exports.MAX_CHUNK_WIDTH = exports.MAX_CHUNK_HEIGHT = exports.generateVerticalChunk = exports.DEFAULT_PATH_NOISE = exports.DEFAULT_CHUNK_WIDTH = exports.DEFAULT_CHUNK_HEIGHT = exports.dualGridMask = exports.hashCoordinate = exports.coordinateUnit = void 0;
+var coordinateHash_1 = require("./coordinateHash");
+Object.defineProperty(exports, "coordinateUnit", { enumerable: true, get: function () { return coordinateHash_1.coordinateUnit; } });
+Object.defineProperty(exports, "hashCoordinate", { enumerable: true, get: function () { return coordinateHash_1.hashCoordinate; } });
+var dualGrid_1 = require("./dualGrid");
+Object.defineProperty(exports, "dualGridMask", { enumerable: true, get: function () { return dualGrid_1.dualGridMask; } });
+var verticalWorld_1 = require("./verticalWorld");
+Object.defineProperty(exports, "DEFAULT_CHUNK_HEIGHT", { enumerable: true, get: function () { return verticalWorld_1.DEFAULT_CHUNK_HEIGHT; } });
+Object.defineProperty(exports, "DEFAULT_CHUNK_WIDTH", { enumerable: true, get: function () { return verticalWorld_1.DEFAULT_CHUNK_WIDTH; } });
+Object.defineProperty(exports, "DEFAULT_PATH_NOISE", { enumerable: true, get: function () { return verticalWorld_1.DEFAULT_PATH_NOISE; } });
+Object.defineProperty(exports, "generateVerticalChunk", { enumerable: true, get: function () { return verticalWorld_1.generateVerticalChunk; } });
+Object.defineProperty(exports, "MAX_CHUNK_HEIGHT", { enumerable: true, get: function () { return verticalWorld_1.MAX_CHUNK_HEIGHT; } });
+Object.defineProperty(exports, "MAX_CHUNK_WIDTH", { enumerable: true, get: function () { return verticalWorld_1.MAX_CHUNK_WIDTH; } });
+Object.defineProperty(exports, "MAX_WORLD_SEED", { enumerable: true, get: function () { return verticalWorld_1.MAX_WORLD_SEED; } });
+Object.defineProperty(exports, "MIN_CHUNK_HEIGHT", { enumerable: true, get: function () { return verticalWorld_1.MIN_CHUNK_HEIGHT; } });
+Object.defineProperty(exports, "MIN_CHUNK_WIDTH", { enumerable: true, get: function () { return verticalWorld_1.MIN_CHUNK_WIDTH; } });
+Object.defineProperty(exports, "resolvePathNoiseSettings", { enumerable: true, get: function () { return verticalWorld_1.resolvePathNoiseSettings; } });
+exports.WORLD_GEN_ENGINE_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkE;AAAzD,gHAAA,cAAc,OAAA;AAAE,gHAAA,cAAc,OAAA;AACvC,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAQrB,iDAWyB;AAVvB,qHAAA,oBAAoB,OAAA;AACpB,oHAAA,mBAAmB,OAAA;AACnB,mHAAA,kBAAkB,OAAA;AAClB,sHAAA,qBAAqB,OAAA;AACrB,iHAAA,gBAAgB,OAAA;AAChB,gHAAA,eAAe,OAAA;AACf,+GAAA,cAAc,OAAA;AACd,iHAAA,gBAAgB,OAAA;AAChB,gHAAA,eAAe,OAAA;AACf,yHAAA,wBAAwB,OAAA;AAGb,QAAA,wBAAwB,GAAG,OAAO,CAAC"}

package/dist/verticalWorld.d.ts

@@ -0,0 +1,59 @@
+export declare const DEFAULT_CHUNK_WIDTH = 9;
+export declare const DEFAULT_CHUNK_HEIGHT = 16;
+export declare const MIN_CHUNK_WIDTH = 4;
+export declare const MAX_CHUNK_WIDTH = 64;
+export declare const MIN_CHUNK_HEIGHT = 4;
+export declare const MAX_CHUNK_HEIGHT = 48;
+export declare const MAX_WORLD_SEED = 4294967295;
+export type PathNoiseSettings = {
+    readonly spread: number;
+    readonly lengthScale: number;
+    readonly smooth: number;
+    readonly hyst: number;
+    readonly gain: number;
+    readonly maxStep: number;
+    readonly startFade: number;
+    readonly margin: number;
+    readonly lowPeriod: number;
+    readonly lowAmp: number;
+    readonly midPeriod: number;
+    readonly midAmp: number;
+    readonly highPeriod: number;
+    readonly highAmp: number;
+    readonly warpAmp: number;
+    readonly warpFreq: number;
+    readonly widthMin: number;
+    readonly widthMax: number;
+    readonly widthPeriod: number;
+};
+export type PathNoisePreset = 'default' | 'classic' | 'calm' | 'arcs' | 'winding' | 'jittery' | 'road' | 'straight';
+export type VerticalWorldRecipe = {
+    readonly width?: number;
+    readonly chunkHeight?: number;
+    readonly terrainIds: {
+        readonly ground: string;
+        readonly path: string;
+    };
+    readonly pathNoise?: Partial<PathNoiseSettings>;
+    readonly preset?: PathNoisePreset;
+};
+export type VerticalChunkRequest = {
+    readonly seed: string;
+    readonly chunkIndex: number;
+    readonly recipe: VerticalWorldRecipe;
+};
+export type VerticalChunk = {
+    readonly schemaVersion: 1;
+    readonly chunkIndex: number;
+    readonly width: number;
+    readonly height: number;
+    readonly cells: readonly (readonly string[])[];
+};
+export declare const DEFAULT_PATH_NOISE: PathNoiseSettings;
+export declare function resolvePathNoiseSettings(preset?: PathNoisePreset, overrides?: Partial<PathNoiseSettings>): PathNoiseSettings;
+/**
+ * Generates one vertical strip chunk. Index 0 is the first chunk at the bottom
+ * of the world; each returned cell row is ordered top-to-bottom, as in the prototype.
+ */
+export declare function generateVerticalChunk(request: VerticalChunkRequest): VerticalChunk;
+//# sourceMappingURL=verticalWorld.d.ts.map

package/dist/verticalWorld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verticalWorld.d.ts","sourceRoot":"","sources":["../src/verticalWorld.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,cAAc,aAAc,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,iBAoB/B,CAAC;AA+GH,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,eAA2B,EACnC,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,iBAAiB,CA4BnB;AAuGD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA2FlF"}

package/dist/verticalWorld.js

@@ -0,0 +1,315 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PATH_NOISE = exports.MAX_WORLD_SEED = exports.MAX_CHUNK_HEIGHT = exports.MIN_CHUNK_HEIGHT = exports.MAX_CHUNK_WIDTH = exports.MIN_CHUNK_WIDTH = exports.DEFAULT_CHUNK_HEIGHT = exports.DEFAULT_CHUNK_WIDTH = void 0;
+exports.resolvePathNoiseSettings = resolvePathNoiseSettings;
+exports.generateVerticalChunk = generateVerticalChunk;
+exports.DEFAULT_CHUNK_WIDTH = 9;
+exports.DEFAULT_CHUNK_HEIGHT = 16;
+exports.MIN_CHUNK_WIDTH = 4;
+exports.MAX_CHUNK_WIDTH = 64;
+exports.MIN_CHUNK_HEIGHT = 4;
+exports.MAX_CHUNK_HEIGHT = 48;
+exports.MAX_WORLD_SEED = 0xffff_ffff;
+exports.DEFAULT_PATH_NOISE = Object.freeze({
+    spread: 0.75,
+    lengthScale: 1,
+    smooth: 3,
+    hyst: 0.3,
+    gain: 1.4,
+    maxStep: 1,
+    startFade: 12,
+    margin: 1,
+    lowPeriod: 6,
+    lowAmp: 1,
+    midPeriod: 3,
+    midAmp: 0.1,
+    highPeriod: 1.7,
+    highAmp: 0,
+    warpAmp: 0,
+    warpFreq: 0.22,
+    widthMin: 1,
+    widthMax: 1,
+    widthPeriod: 14,
+});
+const PATH_NOISE_PRESETS = {
+    default: {},
+    classic: { spread: 1, smooth: 0, hyst: 0, gain: 2.2, startFade: 1e9 },
+    calm: {
+        warpAmp: 0.8,
+        warpFreq: 0.12,
+        lowPeriod: 10,
+        midPeriod: 5,
+        midAmp: 0.25,
+        highAmp: 0,
+        gain: 1.8,
+        spread: 0.8,
+        smooth: 2.5,
+        hyst: 0.25,
+    },
+    arcs: {
+        lowPeriod: 14,
+        midAmp: 0.2,
+        highAmp: 0,
+        warpAmp: 0.6,
+        gain: 2,
+        spread: 1,
+        smooth: 3.5,
+        hyst: 0.3,
+    },
+    winding: {
+        lowPeriod: 5,
+        midAmp: 0.9,
+        highPeriod: 1.5,
+        highAmp: 0.3,
+        warpAmp: 2.4,
+        warpFreq: 0.3,
+        gain: 3,
+        smooth: 1.2,
+        hyst: 0.2,
+        maxStep: 2,
+        spread: 1,
+    },
+    jittery: {
+        midAmp: 0.8,
+        highPeriod: 1.3,
+        highAmp: 0.8,
+        warpAmp: 1.2,
+        gain: 3,
+        smooth: 0.6,
+        hyst: 0.3,
+        maxStep: 2,
+        spread: 1,
+    },
+    road: {
+        warpAmp: 1,
+        warpFreq: 0.15,
+        lowPeriod: 9,
+        midAmp: 0.3,
+        highAmp: 0.05,
+        gain: 1.8,
+        spread: 0.7,
+        smooth: 2.5,
+        hyst: 0.25,
+        margin: 2,
+        widthMin: 2,
+        widthMax: 3,
+        widthPeriod: 18,
+    },
+    straight: { warpAmp: 0, midAmp: 0.1, highAmp: 0, gain: 1.4, spread: 0.35, smooth: 3, hyst: 0.3 },
+};
+const NOISE_LIMITS = {
+    spread: [0, 1, false],
+    lengthScale: [0.3, 4, false],
+    smooth: [0, 10, false],
+    hyst: [0, 0.45, false],
+    gain: [0.2, 6, false],
+    maxStep: [1, 4, true],
+    startFade: [1, 1e9, false],
+    margin: [0, 4, true],
+    lowPeriod: [1, 30, false],
+    lowAmp: [0, 2, false],
+    midPeriod: [0.5, 15, false],
+    midAmp: [0, 2, false],
+    highPeriod: [0.5, 6, false],
+    highAmp: [0, 2, false],
+    warpAmp: [0, 4, false],
+    warpFreq: [0.02, 1, false],
+    widthMin: [1, 9, true],
+    widthMax: [1, 9, true],
+    widthPeriod: [4, 60, true],
+};
+function assertIntegerInRange(name, value, minimum, maximum) {
+    if (!Number.isSafeInteger(value) || Object.is(value, -0) || value < minimum || value > maximum) {
+        throw new RangeError(`${name} must be an integer from ${minimum} through ${maximum}`);
+    }
+}
+function assertSeed(seed) {
+    if (!/^(0|[1-9]\d*)$/.test(seed) || Number(seed) > exports.MAX_WORLD_SEED) {
+        throw new RangeError(`seed must be a canonical decimal uint32 string (0-${exports.MAX_WORLD_SEED})`);
+    }
+}
+function assertTerrainId(name, value) {
+    if (value.trim() !== value || value.length === 0 || value.length > 128) {
+        throw new RangeError(`${name} must be a non-empty trimmed identifier up to 128 characters`);
+    }
+}
+function resolvePathNoiseSettings(preset = 'default', overrides = {}) {
+    const presetSettings = PATH_NOISE_PRESETS[preset];
+    if (presetSettings === undefined) {
+        throw new RangeError(`Unknown path-noise preset: ${String(preset)}`);
+    }
+    for (const key of Object.keys(overrides)) {
+        if (!Object.hasOwn(exports.DEFAULT_PATH_NOISE, key)) {
+            throw new RangeError(`Unknown path-noise setting: ${key}`);
+        }
+    }
+    const settings = { ...exports.DEFAULT_PATH_NOISE, ...presetSettings, ...overrides };
+    for (const [key, value] of Object.entries(settings)) {
+        const [minimum, maximum, integer] = NOISE_LIMITS[key];
+        if (!Number.isFinite(value) ||
+            value < minimum ||
+            value > maximum ||
+            (integer && !Number.isInteger(value))) {
+            throw new RangeError(`${key} must be ${integer ? 'an integer' : 'a number'} from ${minimum} through ${maximum}`);
+        }
+    }
+    return settings;
+}
+function noiseHash(seed, channel, index) {
+    const numericSeed = Number(seed) >>> 0;
+    const lowIndex = index >>> 0;
+    const highIndex = Math.floor(index / 0x1_0000_0000);
+    let hash = (numericSeed ^ Math.imul(channel + 1, 0x9e3779b1) ^ Math.imul(lowIndex, 0x85ebca6b)) >>> 0;
+    if (highIndex > 0) {
+        hash = (hash ^ Math.imul(highIndex, 0x27d4eb2d)) >>> 0;
+    }
+    hash = Math.imul(hash ^ (hash >>> 16), 0x7feb352d);
+    hash = Math.imul(hash ^ (hash >>> 15), 0x846ca68b);
+    hash = (hash ^ (hash >>> 16)) >>> 0;
+    return hash / 0x1_0000_0000;
+}
+function valueNoise1D(seed, channel, position) {
+    const index = Math.floor(position);
+    const fraction = position - index;
+    const smooth = fraction * fraction * fraction * (fraction * (fraction * 6 - 15) + 10);
+    const left = noiseHash(seed, channel, index) * 2 - 1;
+    const right = noiseHash(seed, channel, index + 1) * 2 - 1;
+    return left + (right - left) * smooth;
+}
+function pathNoise(seed, settings, row) {
+    const amplitude = settings.lowAmp + settings.midAmp + settings.highAmp;
+    if (amplitude <= 0) {
+        return 0;
+    }
+    const warp = valueNoise1D(seed, 10, row * settings.warpFreq) * settings.warpAmp;
+    const warpedRow = row + warp;
+    const low = valueNoise1D(seed, 11, warpedRow / (settings.lowPeriod * settings.lengthScale));
+    const mid = valueNoise1D(seed, 12, warpedRow / (settings.midPeriod * settings.lengthScale));
+    const high = valueNoise1D(seed, 13, warpedRow / (settings.highPeriod * settings.lengthScale));
+    return (low * settings.lowAmp + mid * settings.midAmp + high * settings.highAmp) / amplitude;
+}
+function smoothCompensation(settings) {
+    if (settings.smooth <= 0) {
+        return 1;
+    }
+    const layers = [
+        [settings.lowAmp, settings.lowPeriod],
+        [settings.midAmp, settings.midPeriod],
+        [settings.highAmp, settings.highPeriod],
+    ];
+    const alpha = 1 / (1 + settings.smooth);
+    const beta = 1 - alpha;
+    let totalAmplitude = 0;
+    let retainedAmplitude = 0;
+    for (const [amplitude, period] of layers) {
+        if (amplitude === undefined || period === undefined) {
+            throw new Error('Invalid internal path-noise layer');
+        }
+        const angularFrequency = (2 * Math.PI) / Math.max(1.2, period * settings.lengthScale);
+        const response = alpha / Math.sqrt(1 - 2 * beta * Math.cos(angularFrequency) + beta * beta);
+        totalAmplitude += amplitude;
+        retainedAmplitude += amplitude * response * response;
+    }
+    return retainedAmplitude > 0 ? Math.min(5, Math.max(1, totalAmplitude / retainedAmplitude)) : 1;
+}
+function pathWidth(seed, settings, row) {
+    const low = Math.min(settings.widthMin, settings.widthMax);
+    const high = Math.max(settings.widthMin, settings.widthMax);
+    if (low === high) {
+        return low;
+    }
+    const sample = (valueNoise1D(seed, 20, row / settings.widthPeriod) + 1) / 2;
+    const eased = Math.max(0, Math.min(1, (sample - 0.5) * 1.6 + 0.5));
+    return Math.round(low + (high - low) * eased);
+}
+function createCells(width, terrainIds, pathColumns, pathWidthValue) {
+    const cells = Array.from({ length: width }, () => terrainIds.ground);
+    const leftRadius = Math.floor((pathWidthValue - 1) / 2);
+    const rightRadius = Math.ceil((pathWidthValue - 1) / 2);
+    for (const pathColumn of pathColumns) {
+        for (let offset = -leftRadius; offset <= rightRadius; offset += 1) {
+            const column = pathColumn + offset;
+            if (column >= 0 && column < width) {
+                cells[column] = terrainIds.path;
+            }
+        }
+    }
+    return cells;
+}
+/**
+ * Generates one vertical strip chunk. Index 0 is the first chunk at the bottom
+ * of the world; each returned cell row is ordered top-to-bottom, as in the prototype.
+ */
+function generateVerticalChunk(request) {
+    assertSeed(request.seed);
+    assertIntegerInRange('chunkIndex', request.chunkIndex, 0, Number.MAX_SAFE_INTEGER);
+    const width = request.recipe.width ?? exports.DEFAULT_CHUNK_WIDTH;
+    const height = request.recipe.chunkHeight ?? exports.DEFAULT_CHUNK_HEIGHT;
+    assertIntegerInRange('width', width, exports.MIN_CHUNK_WIDTH, exports.MAX_CHUNK_WIDTH);
+    assertIntegerInRange('chunkHeight', height, exports.MIN_CHUNK_HEIGHT, exports.MAX_CHUNK_HEIGHT);
+    const groundId = request.recipe.terrainIds?.ground;
+    const pathId = request.recipe.terrainIds?.path;
+    assertTerrainId('terrainIds.ground', groundId);
+    assertTerrainId('terrainIds.path', pathId);
+    if (groundId === pathId) {
+        throw new RangeError('terrainIds.ground and terrainIds.path must be different');
+    }
+    const settings = resolvePathNoiseSettings(request.recipe.preset, request.recipe.pathNoise);
+    if (settings.widthMin > width || settings.widthMax > width) {
+        throw new RangeError(`path width must not exceed the world width (${width})`);
+    }
+    const firstWorldRow = request.chunkIndex * height;
+    const lastWorldRow = firstWorldRow + height - 1;
+    if (!Number.isSafeInteger(lastWorldRow + 1) || Object.is(lastWorldRow + 1, -0)) {
+        throw new RangeError('chunkIndex and chunkHeight exceed the safe world-row range');
+    }
+    const center = Math.floor((width - 1) / 2);
+    const margin = Math.max(0, Math.min(settings.margin, Math.floor((width - 3) / 2)));
+    const halfWidth = Math.max(0, Math.min(center - margin, width - 1 - center - margin));
+    const baseNoise = pathNoise(request.seed, settings, 0);
+    const compensation = smoothCompensation(settings);
+    const alpha = 1 / (1 + settings.smooth);
+    let column = center;
+    let firstSmooth = center;
+    let secondSmooth = center;
+    const chunkRows = new Array(height);
+    for (let rowIndex = 0; rowIndex <= lastWorldRow; rowIndex += 1) {
+        const pathColumns = [column];
+        const fade = Math.max(0, 1 - (rowIndex + 1) / settings.startFade);
+        const shift = Math.tanh(settings.gain *
+            compensation *
+            (pathNoise(request.seed, settings, rowIndex + 1) - baseNoise * fade));
+        const target = center + halfWidth * settings.spread * shift;
+        secondSmooth += alpha * (target - secondSmooth);
+        firstSmooth += alpha * (secondSmooth - firstSmooth);
+        let desiredColumn = column;
+        if (Math.abs(firstSmooth - column) > 0.5 + settings.hyst) {
+            desiredColumn = Math.round(firstSmooth);
+        }
+        let step = Math.max(-settings.maxStep, Math.min(settings.maxStep, desiredColumn - column));
+        step = Math.max(center - halfWidth, Math.min(center + halfWidth, column + step)) - column;
+        const direction = Math.sign(step);
+        for (let remaining = Math.abs(step); remaining > 0; remaining -= 1) {
+            column += direction;
+            pathColumns.push(column);
+        }
+        if (rowIndex >= firstWorldRow) {
+            const outputRow = lastWorldRow - rowIndex;
+            chunkRows[outputRow] = createCells(width, request.recipe.terrainIds, pathColumns, pathWidth(request.seed, settings, rowIndex));
+        }
+    }
+    const cells = chunkRows.map((row) => {
+        if (row === undefined) {
+            throw new Error('Internal error: generated chunk row is missing');
+        }
+        return row;
+    });
+    return {
+        schemaVersion: 1,
+        chunkIndex: request.chunkIndex,
+        width,
+        height,
+        cells,
+    };
+}
+//# sourceMappingURL=verticalWorld.js.map

package/dist/verticalWorld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verticalWorld.js","sourceRoot":"","sources":["../src/verticalWorld.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@twilite-app/world-gen-engine",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Pure deterministic primitives for Twilite world generation",
+  "license": "UNLICENSED",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.