@dreadwood-types/types 0.1.0

package/dist/xp.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Current cap. Levels are derived from stored XP on load (see db/characters.ts),
+ * so raising this later restores any progress banked above the cap rather than
+ * losing it. Level 40 is the current long-term cap; reaching it is deliberately
+ * a substantial commitment rather than a starter-area milestone.
+ */
+export declare const MAX_LEVEL = 40;
+/**
+ * A welcoming early curve that rises steadily into a long-term level-40 goal.
+ * The first level costs 49 XP instead of 664; each following level takes a
+ * little more work, without the old exponential wall.
+ */
+export declare const PLAYER_MAX_HIT_CAP = 20;
+export declare const XP_TABLE: readonly number[];
+export declare function xpForLevel(level: number): number;
+export declare function levelForXp(xp: number): number;
+export type XpProgress = {
+    level: number;
+    intoLevel: number;
+    span: number;
+    totalXp: number;
+};
+export declare function xpProgress(xp: number): XpProgress;
+export declare function maxHitForStrength(strengthLevel: number): number;
+/**
+ * Unboosted player health is exactly their combat level. Equipment and other
+ * temporary boosts can layer on top later, while the base remains predictable.
+ */
+export declare function maxHealthForLevel(combatLevel: number): number;
+/**
+ * Fraction of an incoming hit that armour removes: `A / (A + ARMOUR_SOFTNESS)`.
+ *
+ * Replaces a subtractive soak (`damage - random(0..armour)`), which had a nasty
+ * cliff: once armour approached the attacker's max hit, damage collapsed toward
+ * zero, so two points either way swung survival from a few minutes to over half
+ * an hour. Measured, not guessed — see scripts/sim-combat.ts.
+ *
+ * A ratio curve has none of that. It gives diminishing returns, never reaches
+ * immunity, and stays predictable to tune.
+ */
+export declare const ARMOUR_SOFTNESS = 18;
+export declare function armourReduction(armour: number): number;
+/**
+ * Combat is derived, not trained directly: it is the average of Weapon Mastery
+ * and the better of Strength or Archery. Taking the higher primary skill means
+ * switching weapons never lowers combat level.
+ */
+export declare function combatLevelFrom(strengthLevel: number, archeryLevel: number, precisionLevel: number): number;
+/**
+ * Effective attack level from a weapon's primary skill (Strength or Archery)
+ * combined with Mastery. Caps at PLAYER_MAX_HIT_CAP for damage, but hit chance
+ * uses the uncapped blend below MAX_LEVEL.
+ */
+export declare function effectiveAttackLevel(primaryLevel: number, precisionLevel: number): number;
+/** Flat damage bonus from a weapon's craft precision (woodwork level when made). */
+export declare function weaponPrecisionBonus(weaponPrecision: number | null | undefined): number;
+/**
+ * Fraction of a weapon's / ammo's flat damage the wielder actually lands.
+ *
+ * Gear damage used to be added raw, entirely independent of the combat skill
+ * swinging it. That made skill almost irrelevant at the low end: a level-1
+ * archer holding a pine bow crafted at woodwork 40 hit for 13-16, of which
+ * exactly 1 came from their archery level and 8 from the *crafter's* woodwork.
+ * Levelling archery from 1 to 20 barely moved the number, while a hand-me-down
+ * bow moved it enormously.
+ *
+ * Scaling the flat bonuses by the wielder's level keeps good gear worth having
+ * without letting it stand in for training: at MAX_LEVEL the weapon performs at
+ * its full printed damage, and at level 1 it lands a quarter of it. The floor
+ * is deliberately non-zero so a starter weapon still beats bare fists.
+ */
+export declare const GEAR_DAMAGE_SCALE_MIN = 0.25;
+export declare function gearDamageScale(attackLevel: number): number;
+//# sourceMappingURL=xp.d.ts.map

package/dist/xp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xp.d.ts","sourceRoot":"","sources":["../src/xp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAYrC,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAAmB,CAAC;AAE1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAYjD;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAIzF;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGvF;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI3D"}

package/dist/xp.js

@@ -0,0 +1,126 @@
+/**
+ * Current cap. Levels are derived from stored XP on load (see db/characters.ts),
+ * so raising this later restores any progress banked above the cap rather than
+ * losing it. Level 40 is the current long-term cap; reaching it is deliberately
+ * a substantial commitment rather than a starter-area milestone.
+ */
+export const MAX_LEVEL = 40;
+/**
+ * A welcoming early curve that rises steadily into a long-term level-40 goal.
+ * The first level costs 49 XP instead of 664; each following level takes a
+ * little more work, without the old exponential wall.
+ */
+export const PLAYER_MAX_HIT_CAP = 20;
+function buildXpTable() {
+    const table = [0, 0];
+    let points = 0;
+    for (let level = 2; level <= MAX_LEVEL; level++) {
+        points += Math.floor(35 + 14 * Math.pow(level - 1, 1.42));
+        table[level] = points;
+    }
+    return table;
+}
+export const XP_TABLE = buildXpTable();
+export function xpForLevel(level) {
+    const clamped = Math.max(1, Math.min(MAX_LEVEL, Math.floor(level)));
+    return XP_TABLE[clamped] ?? 0;
+}
+export function levelForXp(xp) {
+    const safe = Math.max(0, Math.floor(xp));
+    let level = 1;
+    for (let l = 2; l <= MAX_LEVEL; l++) {
+        if (safe >= (XP_TABLE[l] ?? Infinity))
+            level = l;
+        else
+            break;
+    }
+    return level;
+}
+export function xpProgress(xp) {
+    const totalXp = Math.max(0, Math.floor(xp));
+    const level = levelForXp(totalXp);
+    const current = xpForLevel(level);
+    const next = level >= MAX_LEVEL ? current : xpForLevel(level + 1);
+    const span = Math.max(1, next - current);
+    return {
+        level,
+        intoLevel: Math.min(span, totalXp - current),
+        span,
+        totalXp,
+    };
+}
+export function maxHitForStrength(strengthLevel) {
+    const level = Math.max(1, Math.floor(strengthLevel));
+    return Math.min(PLAYER_MAX_HIT_CAP, level);
+}
+/**
+ * Unboosted player health is exactly their combat level. Equipment and other
+ * temporary boosts can layer on top later, while the base remains predictable.
+ */
+export function maxHealthForLevel(combatLevel) {
+    return Math.max(1, Math.min(MAX_LEVEL, Math.floor(combatLevel)));
+}
+/**
+ * Fraction of an incoming hit that armour removes: `A / (A + ARMOUR_SOFTNESS)`.
+ *
+ * Replaces a subtractive soak (`damage - random(0..armour)`), which had a nasty
+ * cliff: once armour approached the attacker's max hit, damage collapsed toward
+ * zero, so two points either way swung survival from a few minutes to over half
+ * an hour. Measured, not guessed — see scripts/sim-combat.ts.
+ *
+ * A ratio curve has none of that. It gives diminishing returns, never reaches
+ * immunity, and stays predictable to tune.
+ */
+export const ARMOUR_SOFTNESS = 18;
+export function armourReduction(armour) {
+    const a = Math.max(0, armour);
+    return a / (a + ARMOUR_SOFTNESS);
+}
+/**
+ * Combat is derived, not trained directly: it is the average of Weapon Mastery
+ * and the better of Strength or Archery. Taking the higher primary skill means
+ * switching weapons never lowers combat level.
+ */
+export function combatLevelFrom(strengthLevel, archeryLevel, precisionLevel) {
+    const primary = Math.max(1, Math.floor(Math.max(strengthLevel, archeryLevel)));
+    const precision = Math.max(1, Math.floor(precisionLevel));
+    return Math.max(1, Math.min(MAX_LEVEL, Math.floor((primary + precision) / 2)));
+}
+/**
+ * Effective attack level from a weapon's primary skill (Strength or Archery)
+ * combined with Mastery. Caps at PLAYER_MAX_HIT_CAP for damage, but hit chance
+ * uses the uncapped blend below MAX_LEVEL.
+ */
+export function effectiveAttackLevel(primaryLevel, precisionLevel) {
+    const primary = Math.max(1, Math.floor(primaryLevel));
+    const precision = Math.max(1, Math.floor(precisionLevel));
+    return Math.min(MAX_LEVEL, primary + Math.floor(precision / 2));
+}
+/** Flat damage bonus from a weapon's craft precision (woodwork level when made). */
+export function weaponPrecisionBonus(weaponPrecision) {
+    if (weaponPrecision == null || !Number.isFinite(weaponPrecision))
+        return 0;
+    return Math.max(0, Math.floor(weaponPrecision / 5));
+}
+/**
+ * Fraction of a weapon's / ammo's flat damage the wielder actually lands.
+ *
+ * Gear damage used to be added raw, entirely independent of the combat skill
+ * swinging it. That made skill almost irrelevant at the low end: a level-1
+ * archer holding a pine bow crafted at woodwork 40 hit for 13-16, of which
+ * exactly 1 came from their archery level and 8 from the *crafter's* woodwork.
+ * Levelling archery from 1 to 20 barely moved the number, while a hand-me-down
+ * bow moved it enormously.
+ *
+ * Scaling the flat bonuses by the wielder's level keeps good gear worth having
+ * without letting it stand in for training: at MAX_LEVEL the weapon performs at
+ * its full printed damage, and at level 1 it lands a quarter of it. The floor
+ * is deliberately non-zero so a starter weapon still beats bare fists.
+ */
+export const GEAR_DAMAGE_SCALE_MIN = 0.25;
+export function gearDamageScale(attackLevel) {
+    const level = Math.max(1, Math.min(MAX_LEVEL, Math.floor(attackLevel)));
+    const t = (level - 1) / (MAX_LEVEL - 1);
+    return GEAR_DAMAGE_SCALE_MIN + (1 - GEAR_DAMAGE_SCALE_MIN) * t;
+}
+//# sourceMappingURL=xp.js.map

package/dist/xp.js.map

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

package/dist/zones.d.ts

@@ -0,0 +1,30 @@
+export type WorldZoneId = 'safe' | 'deadlands';
+export declare const DEADLANDS_WIDTH = 448;
+export declare const DEADLANDS_DEPTH = 448;
+export declare const DEADLANDS_MIN_X: number;
+export declare const DEADLANDS_MAX_X: number;
+export declare const DEADLANDS_MIN_Z: number;
+export declare const DEADLANDS_MAX_Z: number;
+export declare const DEADLANDS_GATE_X: number;
+export declare const DEADLANDS_DEFENSE_DEPTH = 3;
+export declare const DEADLANDS_WALL_TERRAIN_H = 2;
+export declare const DEADLANDS_TOWER_MIN_GAP = 12;
+export declare const DEADLANDS_BOUNDS: {
+    readonly minX: number;
+    readonly maxX: number;
+    readonly minZ: number;
+    readonly maxZ: number;
+};
+export declare const ZONE_DISPLAY_NAME: Record<WorldZoneId, string>;
+export declare function isPlayableTile(x: number, z: number): boolean;
+export declare function zoneAt(x: number, z: number): WorldZoneId;
+export declare function zoneDisplayName(zone: WorldZoneId): string;
+export declare function isDeadlands(x: number, z: number): boolean;
+export declare function isPvpZone(x: number, z: number): boolean;
+export declare function isDeadlandsPerimeter(x: number, z: number): boolean;
+export declare function isDeadlandsDefenseBand(x: number, z: number): boolean;
+export declare function collectDeadlandsTowerSpots(): {
+    x: number;
+    z: number;
+}[];
+//# sourceMappingURL=zones.d.ts.map

package/dist/zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zones.d.ts","sourceRoot":"","sources":["../src/zones.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,eAAe,QAAkD,CAAC;AAC/E,eAAO,MAAM,eAAe,QAAwC,CAAC;AACrE,eAAO,MAAM,eAAe,QAAmD,CAAC;AAChF,eAAO,MAAM,eAAe,QAAwC,CAAC;AACrE,eAAO,MAAM,gBAAgB,QAAsD,CAAC;AACpF,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,gBAAgB;aAC3B,IAAI;aACJ,IAAI;aACJ,IAAI;aACJ,IAAI;CACI,CAAC;AAEX,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAGzD,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAaxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAQlE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CA6BpE;AAQD,wBAAgB,0BAA0B,IAAI;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CA+CvE"}

package/dist/zones.js

@@ -0,0 +1,143 @@
+import { PLAYABLE_HEIGHT, PLAYABLE_ORIGIN_X, PLAYABLE_ORIGIN_Z, PLAYABLE_WIDTH, WORLD_HEIGHT, WORLD_WIDTH, } from './constants.js';
+export const DEADLANDS_WIDTH = 448;
+export const DEADLANDS_DEPTH = 448;
+export const DEADLANDS_MIN_X = Math.floor((WORLD_WIDTH - DEADLANDS_WIDTH) / 2);
+export const DEADLANDS_MAX_X = DEADLANDS_MIN_X + DEADLANDS_WIDTH - 1;
+export const DEADLANDS_MIN_Z = Math.floor((WORLD_HEIGHT - DEADLANDS_DEPTH) / 2);
+export const DEADLANDS_MAX_Z = DEADLANDS_MIN_Z + DEADLANDS_DEPTH - 1;
+export const DEADLANDS_GATE_X = Math.floor((DEADLANDS_MIN_X + DEADLANDS_MAX_X) / 2);
+export const DEADLANDS_DEFENSE_DEPTH = 3;
+export const DEADLANDS_WALL_TERRAIN_H = 2;
+export const DEADLANDS_TOWER_MIN_GAP = 12;
+export const DEADLANDS_BOUNDS = {
+    minX: DEADLANDS_MIN_X,
+    maxX: DEADLANDS_MAX_X,
+    minZ: DEADLANDS_MIN_Z,
+    maxZ: DEADLANDS_MAX_Z,
+};
+export const ZONE_DISPLAY_NAME = {
+    safe: 'Safe zone',
+    deadlands: 'Dreadwoods',
+};
+export function isPlayableTile(x, z) {
+    return (x >= PLAYABLE_ORIGIN_X &&
+        x < PLAYABLE_ORIGIN_X + PLAYABLE_WIDTH &&
+        z >= PLAYABLE_ORIGIN_Z &&
+        z < PLAYABLE_ORIGIN_Z + PLAYABLE_HEIGHT);
+}
+export function zoneAt(x, z) {
+    const tx = Math.floor(x);
+    const tz = Math.floor(z);
+    if (tx < 0 || tz < 0 || tx >= WORLD_WIDTH || tz >= WORLD_HEIGHT)
+        return 'safe';
+    if (tx >= DEADLANDS_MIN_X &&
+        tx <= DEADLANDS_MAX_X &&
+        tz >= DEADLANDS_MIN_Z &&
+        tz <= DEADLANDS_MAX_Z) {
+        return 'deadlands';
+    }
+    return 'safe';
+}
+export function zoneDisplayName(zone) {
+    return ZONE_DISPLAY_NAME[zone];
+}
+export function isDeadlands(x, z) {
+    return zoneAt(x, z) === 'deadlands';
+}
+export function isPvpZone(x, z) {
+    return isDeadlands(x, z);
+}
+export function isDeadlandsPerimeter(x, z) {
+    if (!isDeadlands(x, z))
+        return false;
+    return (x === DEADLANDS_MIN_X ||
+        x === DEADLANDS_MAX_X ||
+        z === DEADLANDS_MIN_Z ||
+        z === DEADLANDS_MAX_Z);
+}
+export function isDeadlandsDefenseBand(x, z) {
+    if (isDeadlands(x, z))
+        return false;
+    const nearX = x >= DEADLANDS_MIN_X - DEADLANDS_DEFENSE_DEPTH &&
+        x <= DEADLANDS_MAX_X + DEADLANDS_DEFENSE_DEPTH;
+    const nearZ = z >= DEADLANDS_MIN_Z - DEADLANDS_DEFENSE_DEPTH &&
+        z <= DEADLANDS_MAX_Z + DEADLANDS_DEFENSE_DEPTH;
+    if (!nearX || !nearZ)
+        return false;
+    const outsideRing = x < DEADLANDS_MIN_X ||
+        x > DEADLANDS_MAX_X ||
+        z < DEADLANDS_MIN_Z ||
+        z > DEADLANDS_MAX_Z;
+    if (!outsideRing)
+        return false;
+    const dx = x < DEADLANDS_MIN_X
+        ? DEADLANDS_MIN_X - x
+        : x > DEADLANDS_MAX_X
+            ? x - DEADLANDS_MAX_X
+            : 0;
+    const dz = z < DEADLANDS_MIN_Z
+        ? DEADLANDS_MIN_Z - z
+        : z > DEADLANDS_MAX_Z
+            ? z - DEADLANDS_MAX_Z
+            : 0;
+    const dist = Math.max(dx, dz);
+    return dist >= 1 && dist <= DEADLANDS_DEFENSE_DEPTH;
+}
+function towerHash(x, z, salt) {
+    let n = x * 374761393 + z * 668265263 + salt;
+    n = (n ^ (n >> 13)) * 1274126177;
+    return (n ^ (n >> 16)) >>> 0;
+}
+export function collectDeadlandsTowerSpots() {
+    const spots = [];
+    const seen = new Set();
+    const tooClose = (x, z) => {
+        for (const s of spots) {
+            if (Math.abs(s.x - x) + Math.abs(s.z - z) < DEADLANDS_TOWER_MIN_GAP)
+                return true;
+        }
+        return false;
+    };
+    const push = (x, z) => {
+        const k = `${x},${z}`;
+        if (seen.has(k))
+            return;
+        if (!isDeadlands(x, z))
+            return;
+        seen.add(k);
+        spots.push({ x, z });
+    };
+    push(DEADLANDS_MIN_X, DEADLANDS_MIN_Z);
+    push(DEADLANDS_MAX_X, DEADLANDS_MIN_Z);
+    push(DEADLANDS_MIN_X, DEADLANDS_MAX_Z);
+    push(DEADLANDS_MAX_X, DEADLANDS_MAX_Z);
+    const wall = [];
+    for (let x = DEADLANDS_MIN_X + 1; x <= DEADLANDS_MAX_X - 1; x++) {
+        wall.push({ x, z: DEADLANDS_MIN_Z });
+        wall.push({ x, z: DEADLANDS_MAX_Z });
+    }
+    for (let z = DEADLANDS_MIN_Z + 1; z <= DEADLANDS_MAX_Z - 1; z++) {
+        wall.push({ x: DEADLANDS_MIN_X, z });
+        wall.push({ x: DEADLANDS_MAX_X, z });
+    }
+    for (const p of wall) {
+        const n = towerHash(p.x, p.z, 901);
+        if (n % 11 !== 0 && n % 13 !== 1)
+            continue;
+        if (tooClose(p.x, p.z))
+            continue;
+        push(p.x, p.z);
+    }
+    for (let z = DEADLANDS_MIN_Z + 4; z <= DEADLANDS_MAX_Z - 4; z += 3) {
+        for (let x = DEADLANDS_MIN_X + 4; x <= DEADLANDS_MAX_X - 4; x += 3) {
+            const n = towerHash(x, z, 1703);
+            if (n % 47 !== 0)
+                continue;
+            if (tooClose(x, z))
+                continue;
+            push(x, z);
+        }
+    }
+    return spots;
+}
+//# sourceMappingURL=zones.js.map

package/dist/zones.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@dreadwood-types/types",
+  "version": "0.1.0",
+  "description": "Public wire protocol and client-safe constants for Dreadwoods",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JamesPhelps/dreadwoods-types.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}