iets-dev 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,59 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm install)",
+      "Bash(pnpm iesdp-update:*)",
+      "Bash(pnpm typecheck:*)",
+      "Bash(pnpm lint:*)",
+      "Bash(pnpm test:*)",
+      "Bash(grep:*)",
+      "Bash(pnpm exec tsc:*)",
+      "Bash(pnpm exec tsx:*)",
+      "WebFetch(domain:iesdp.bgforge.net)",
+      "Bash(./scripts/iesdp-update.sh:*)",
+      "Bash(pnpm ts-update:*)",
+      "Bash(pnpm exec vitest:*)",
+      "Bash(find:*)",
+      "Bash(ls:*)",
+      "WebFetch(domain:ielib.bgforge.net)",
+      "Bash(while read file)",
+      "Bash(do grep -q \"name: Area\" \"$file\")",
+      "Bash(echo:*)",
+      "Bash(done)",
+      "Bash(git diff:*)",
+      "Bash(xargs sed:*)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/ielib tag --sort=-v:refname)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/ielib log --oneline --all --grep=\"0.2.0\" -- ts/)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/ielib log --oneline --all -S '\"\"0.2.0\"\"' -- ts/ielib/package.json)",
+      "Bash(fi)",
+      "Bash(head:*)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline --all)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline -- ts/)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline -- scripts/)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline -- package.json tsconfig.json eslint.config.js pnpm-workspace.yaml)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline -200)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --oneline --name-status -- ts/ scripts/)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets log --all --oneline --name-only --reverse)",
+      "Bash(git filter-repo:*)",
+      "Bash(git mv:*)",
+      "Bash(git -C /home/magi/data/work/sexydev/bg2/iets status)",
+      "Bash(pnpm --dir /home/magi/data/work/sexydev/bg2/iets test:*)",
+      "WebSearch",
+      "Bash(pnpm docs:*)",
+      "Bash(pnpm exec typedoc:*)",
+      "Bash(pnpm build-docs:*)",
+      "WebFetch(domain:starlight.astro.build)",
+      "WebFetch(domain:www.npmjs.com)",
+      "WebFetch(domain:starlight-typedoc.vercel.app)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:starlight-typedoc-example.vercel.app)",
+      "WebFetch(domain:typedoc.org)",
+      "Bash(timeout 15 pnpm serve-docs:*)",
+      "Bash(curl:*)",
+      "WebFetch(domain:folib.bgforge.net)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(CI=true pnpm install:*)"
+    ]
+  }
+}

package/.github/workflows/build.yml

@@ -0,0 +1,33 @@
+name: Build
+
+on: [push]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "pnpm"
+
+      - name: Install Node dependencies
+        run: pnpm install
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Type check
+        run: pnpm typecheck
+
+      - name: Test
+        run: pnpm test

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,24 @@
+name: NPM publish
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - src/**
+      - .github/workflows/**
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm publish --provenance --access public
+        working-directory: src

package/CLAUDE.md

@@ -0,0 +1,68 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+BGforge IETS -- a TypeScript type package for Infinity Engine scripting (Baldur's Gate 2). Published to npm as `@bgforge/iets`. Provides branded types, object specifiers, IDS constant files, and typed action/trigger declarations for IDE integration.
+
+## Commands
+
+```bash
+pnpm install              # Install dependencies (never use npm/npx)
+pnpm lint                 # ESLint (strict type-checked, flat config) on scripts/
+pnpm typecheck            # TypeScript strict check on scripts/
+pnpm test                 # Vitest unit tests
+pnpm ts-update            # Regenerate TypeScript declarations from IESDP
+```
+
+Run a single test file:
+```bash
+pnpm exec vitest run scripts/ts-update.test.ts
+```
+
+Run tests matching a name pattern:
+```bash
+pnpm exec vitest run -t "pattern"
+```
+
+## Architecture
+
+### TypeScript package (`src/`)
+
+npm package (pnpm workspace) published via `npm-publish.yml` workflow. Provides branded types (`IE<T, B>`), object specifiers, and `.ids.ts` constant files for IDE integration.
+
+#### Type branding conventions
+
+- Numeric IDS types use `IE<number, "TypeName">` for nominal type safety. Users create custom values with `42 as SpellID`.
+- String resref types (`ResRef`, `SplRef`, `ItmRef`) intentionally use `string & {}` instead of `IE<string, ...>` -- resrefs are almost always raw string literals and branding would require a cast on every usage. Unlike numeric IDS types, there is no finite set of valid resrefs to provide as pre-typed constants.
+- `Action` uses a branded interface so that `ActionOverride` can enforce its argument is an actual action call.
+
+#### IDS type naming
+
+Some IDS types use a `*ID` suffix (`ClassID`, `GenderID`, `KitID`, etc.) while others use bare names (`Align`, `EA`, `State`, etc.). This is not inconsistency -- the suffix exists to avoid name clashes with trigger/action functions (e.g. `Class()` trigger vs `ClassID` type, `Gender()` trigger vs `GenderID` type). Types without a same-named function use the bare name.
+
+### Code generation pipeline
+
+`external/iesdp/` contains IESDP data (dynamically cloned from `BGforgeNet/iesdp`, branch `ielib`, via `scripts/ensure-iesdp.sh` -- not a git submodule).
+
+- `scripts/ts-update.ts` reads IESDP YAML/HTML -> generates `src/bg2/actions.d.ts` and `src/bg2/triggers.d.ts`
+- `scripts/barrel-generator.ts` generates `src/bg2/index.ts` barrel file from sibling modules
+
+### Scripts
+
+- `scripts/ts-update.ts` -- TypeScript declaration generator
+- `scripts/ts-update.test.ts` -- Tests for ts-update
+- `scripts/ts-update.sh` -- Shell wrapper for ts-update
+- `scripts/barrel-generator.ts` -- Barrel file generator
+- `scripts/barrel-generator.test.ts` -- Tests for barrel generator
+- `scripts/utils.ts` -- Shared utilities (readFile, log, etc.)
+- `scripts/ensure-iesdp.sh` -- IESDP data fetcher
+
+## TypeScript strict settings
+
+`tsconfig.json` enables `noUncheckedIndexedAccess` and `noImplicitReturns` -- all array/object index access may be `undefined`, and all code paths must return.
+
+## CI/CD
+
+GitHub Actions (`build.yml`): lint + typecheck + test on every push. npm publish (`npm-publish.yml`) triggers on `src/**` changes (Node 24).

package/README.md

@@ -0,0 +1,21 @@
+# BGforge IETS
+[![Telegram](https://img.shields.io/badge/telegram-join%20%20%20%20%E2%9D%B1%E2%9D%B1%E2%9D%B1-darkorange?logo=telegram)](https://t.me/bgforge)
+[![Discord](https://img.shields.io/discord/420268540700917760?logo=discord&label=discord&color=blue&logoColor=FEE75C)](https://discord.gg/4Yqfggm)
+[![IRC](https://img.shields.io/badge/%23IRC-join%20%20%20%20%E2%9D%B1%E2%9D%B1%E2%9D%B1-darkorange)](https://bgforge.net/irc)
+[![Patreon](https://img.shields.io/badge/Patreon-donate-FF424D?logo=Patreon&labelColor=141518)](https://www.patreon.com/BGforge)
+
+TypeScript type definitions for Infinity Engine scripting. Can be used in [TBAF](https://forums.bgforge.net/viewtopic.php?t=448).
+
+Provides branded types, object specifiers, IDS constants, and typed action/trigger function declarations for IDE autocompletion and type checking.
+
+### Installation
+
+```bash
+pnpm install @bgforge/iets
+```
+
+### Usage
+
+```typescript
+import { ActionOverride, MoveToPoint } from "@bgforge/iets/bg2";
+```

package/eslint.config.js

@@ -0,0 +1,34 @@
+/**
+ * ESLint configuration for scripts directory.
+ *
+ * Uses flat config format (ESLint 9+).
+ */
+
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.strictTypeChecked,
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      // Allow numbers and booleans in template literals
+      "@typescript-eslint/restrict-template-expressions": [
+        "error",
+        { allowNumber: true, allowBoolean: true },
+      ],
+    },
+  },
+  {
+    files: ["scripts/**/*.ts"],
+  },
+  {
+    ignores: ["node_modules", "external", "src", "**/*.js"],
+  }
+);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "iets-dev",
+  "version": "1.0.0",
+  "type": "module",
+  "dependencies": {
+    "js-yaml": "^4.1.1",
+    "jsdom": "^25.0.1",
+    "tsx": "^4.21.0",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/js-yaml": "^4.0.9",
+    "@types/jsdom": "^21.1.7",
+    "@types/node": "^22.19.3",
+    "@types/yargs": "^17.0.35",
+    "eslint": "^9.39.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "lint": "eslint scripts/",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p src/tsconfig.json",
+    "ts-update": "tsx scripts/ts-update.ts external/iesdp/_data/actions src/bg2/actions.d.ts external/iesdp/scripting/triggers/bg2triggers.htm src/bg2/triggers.d.ts",
+    "test": "vitest run"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+packages:
+  - "."
+
+onlyBuiltDependencies:
+  - esbuild

package/scripts/barrel-generator.test.ts

@@ -0,0 +1,155 @@
+/**
+ * Tests for the barrel file generator utilities.
+ */
+
+import { describe, it, expect } from "vitest";
+import { extractExportedNames, toModulePath, moduleSection, Section, formatExportLine } from "./barrel-generator";
+
+describe("extractExportedNames", () => {
+  it("extracts type-only exports", () => {
+    const content = `import type { IE } from "../index";\n\nexport declare type Align = IE<number, "Align">;`;
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual(["Align"]);
+    expect(result.values).toEqual([]);
+  });
+
+  it("extracts value-only exports (declare const)", () => {
+    const content = `export declare const ENEMY: EA;\nexport declare const ALLY: EA;`;
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual([]);
+    expect(result.values).toEqual(["ENEMY", "ALLY"]);
+  });
+
+  it("extracts mixed type and value exports", () => {
+    const content = [
+      `export declare type Modal = IE<number, "Modal">;`,
+      `export declare const NONE: Modal;`,
+      `export declare const BATTLESONG: Modal;`,
+    ].join("\n");
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual(["Modal"]);
+    expect(result.values).toEqual(["NONE", "BATTLESONG"]);
+  });
+
+  it("extracts declare function exports", () => {
+    const content = [
+      `export declare function LeaderOf(target?: ObjectPtr): ObjectPtr;`,
+      `export declare const Myself: ObjectPtr;`,
+    ].join("\n");
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual([]);
+    expect(result.values).toEqual(["LeaderOf", "Myself"]);
+  });
+
+  it("deduplicates overloaded function declarations", () => {
+    const content = [
+      `export declare function Help(): Action;`,
+      `export declare function Help(who: ObjectPtr): boolean;`,
+    ].join("\n");
+    const result = extractExportedNames(content);
+    expect(result.values).toEqual(["Help"]);
+  });
+
+  it("extracts enum exports", () => {
+    const content = `export enum Direction {\n  S = 0,\n  N = 8,\n}`;
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual([]);
+    expect(result.values).toEqual(["Direction"]);
+  });
+
+  it("extracts declare enum exports", () => {
+    const content = `export declare enum Animate {\n  FIRE_RING = 0x0000,\n  CHUNKS = 0x0100,\n}`;
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual([]);
+    expect(result.values).toEqual(["Animate"]);
+  });
+
+  it("extracts const exports (non-declare)", () => {
+    const content = `export const NearestEnemyOf = DefaultSelf;`;
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual([]);
+    expect(result.values).toEqual(["NearestEnemyOf"]);
+  });
+
+  it("returns empty arrays for content with no exports", () => {
+    const content = `import type { IE } from "../index";\nconst x = 1;`;
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual([]);
+    expect(result.values).toEqual([]);
+  });
+
+  it("ignores import statements", () => {
+    const content = [
+      `import type { IE } from "../index";`,
+      `import { ObjectPtr } from "..";`,
+      `export declare type Foo = IE<number, "Foo">;`,
+    ].join("\n");
+    const result = extractExportedNames(content);
+    expect(result.types).toEqual(["Foo"]);
+    expect(result.values).toEqual([]);
+  });
+});
+
+describe("toModulePath", () => {
+  it("strips .ts extension", () => {
+    expect(toModulePath("foo.ts")).toBe("./foo");
+  });
+
+  it("strips .ts but keeps .d infix", () => {
+    expect(toModulePath("foo.d.ts")).toBe("./foo.d");
+  });
+
+  it("strips .ts but keeps .ids.d infix", () => {
+    expect(toModulePath("align.ids.d.ts")).toBe("./align.ids.d");
+  });
+
+  it("handles plain .ids.ts files", () => {
+    expect(toModulePath("dir.ids.ts")).toBe("./dir.ids");
+  });
+});
+
+describe("moduleSection", () => {
+  it("classifies actions", () => {
+    expect(moduleSection("./actions.d")).toBe(Section.Actions);
+  });
+
+  it("classifies triggers", () => {
+    expect(moduleSection("./triggers.d")).toBe(Section.Triggers);
+  });
+
+  it("classifies help", () => {
+    expect(moduleSection("./help.d")).toBe(Section.Help);
+  });
+
+  it("classifies IDS modules", () => {
+    expect(moduleSection("./align.ids.d")).toBe(Section.IDS);
+    expect(moduleSection("./object.d")).toBe(Section.IDS);
+    expect(moduleSection("./dir.ids")).toBe(Section.IDS);
+  });
+});
+
+describe("formatExportLine", () => {
+  it("formats single name inline", () => {
+    expect(formatExportLine("export", ["A"], "./mod"))
+      .toBe("export { A } from './mod';");
+  });
+
+  it("formats multiple names one per line", () => {
+    const result = formatExportLine("export", ["A", "B", "C"], "./mod");
+    expect(result).toBe(
+      "export {\n  A,\n  B,\n  C,\n} from './mod';",
+    );
+  });
+
+  it("formats export type keyword", () => {
+    expect(formatExportLine("export type", ["Foo"], "./mod"))
+      .toBe("export type { Foo } from './mod';");
+  });
+
+  it("formats export type with multiple names one per line", () => {
+    const result = formatExportLine("export type", ["Bar", "Foo"], "./mod");
+    expect(result).toBe(
+      "export type {\n  Bar,\n  Foo,\n} from './mod';",
+    );
+  });
+});

package/scripts/barrel-generator.ts

@@ -0,0 +1,207 @@
+/**
+ * Barrel file generator for bg2/index.ts.
+ *
+ * Scans all TypeScript source files in a directory, extracts their exported
+ * names, and generates a barrel re-export file grouped by section.
+ */
+
+import * as fs from "fs";
+import * as path from "path";
+import { log } from "./utils.js";
+
+// Types
+
+export interface ModuleExports {
+  types: string[];
+  values: string[];
+}
+
+/**
+ * Barrel section indices. Modules are grouped into sections, then sorted
+ * alphabetically within each section.
+ */
+export const enum Section {
+  Actions = 0,
+  IDS = 1,
+  Triggers = 2,
+  Help = 3,
+}
+
+// Constants
+
+const SECTION_COMMENTS: Readonly<Record<Section, string>> = {
+  [Section.Actions]: "// --- Actions (generated from IESDP) ---",
+  [Section.IDS]: "// --- IDS types and constants ---",
+  [Section.Triggers]: "// --- Triggers (generated from IESDP) ---",
+  [Section.Help]: "// Help() is both an action and a trigger -- lives in a separate file.",
+};
+
+const OBJECT_MODULES = new Set(["./object.d", "./object"]);
+
+const BARREL_HEADER = [
+  "/**",
+  " * BG2 barrel re-exports.",
+  " *",
+  " * Generated by ts-update. Do not edit manually.",
+  " *",
+  " * Uses named re-exports (not export *) so esbuild can statically resolve each",
+  " * binding without falling back to runtime __reExport helpers for externalized",
+  " * .d.ts modules.",
+  " */",
+  "",
+];
+
+// Functions
+
+/**
+ * Extracts exported type and value names from a TypeScript source file.
+ * Deduplicates function overloads (same name exported multiple times).
+ */
+export function extractExportedNames(fileContent: string): ModuleExports {
+  const types = new Set<string>();
+  const values = new Set<string>();
+
+  for (const line of fileContent.split("\n")) {
+    let match;
+    if ((match = line.match(/^export declare type (\w+)/))) {
+      const name = match[1];
+      if (name) types.add(name);
+    } else if ((match = line.match(/^export declare (?:const|function|enum) (\w+)/))) {
+      const name = match[1];
+      if (name) values.add(name);
+    } else if ((match = line.match(/^export (?:enum|const) (\w+)/))) {
+      const name = match[1];
+      if (name) values.add(name);
+    }
+  }
+
+  return { types: [...types], values: [...values] };
+}
+
+/**
+ * Computes the import path for a source file relative to the barrel.
+ * Strips the `.ts` suffix; keeps `.d` and `.ids.d` infixes intact.
+ * - `foo.ids.d.ts` -> `./foo.ids.d`
+ * - `foo.d.ts` -> `./foo.d`
+ * - `foo.ts` -> `./foo`
+ */
+export function toModulePath(filename: string): string {
+  return `./${filename.replace(/\.ts$/, "")}`;
+}
+
+/**
+ * Returns the barrel section for a given module path.
+ */
+export function moduleSection(modulePath: string): Section {
+  if (modulePath === "./actions.d") return Section.Actions;
+  if (modulePath === "./triggers.d") return Section.Triggers;
+  if (modulePath === "./help.d") return Section.Help;
+  return Section.IDS;
+}
+
+/**
+ * Formats an export statement with one symbol per line.
+ */
+export function formatExportLine(keyword: "export" | "export type", names: readonly string[], modulePath: string): string {
+  if (names.length === 1) {
+    return `${keyword} { ${names[0]} } from '${modulePath}';`;
+  }
+
+  const lines = [
+    `${keyword} {`,
+    ...names.map((name) => `  ${name},`),
+    `} from '${modulePath}';`,
+  ];
+  return lines.join("\n");
+}
+
+/**
+ * Builds sorted module map from source files in a directory.
+ * Reads each .ts file (excluding index.ts), extracts exports, sorts names.
+ */
+function buildModuleMap(bg2Dir: string): Map<string, ModuleExports> {
+  const allFiles = fs.readdirSync(bg2Dir)
+    .filter((f) => f !== "index.ts" && f.endsWith(".ts"));
+
+  const moduleMap = new Map<string, ModuleExports>();
+  for (const file of allFiles) {
+    const content = fs.readFileSync(path.join(bg2Dir, file), "utf-8");
+    const exports = extractExportedNames(content);
+    if (exports.types.length === 0 && exports.values.length === 0) {
+      continue;
+    }
+    const sorted: ModuleExports = {
+      types: [...exports.types].sort(),
+      values: [...exports.values].sort(),
+    };
+    moduleMap.set(toModulePath(file), sorted);
+  }
+
+  return moduleMap;
+}
+
+/**
+ * Assembles barrel file output lines from a sorted module map.
+ * Groups modules by section with decorative comments.
+ */
+function buildBarrelOutput(moduleMap: Map<string, ModuleExports>): string[] {
+  const sortedModules = [...moduleMap.keys()].sort((a, b) => {
+    const sd = moduleSection(a) - moduleSection(b);
+    return sd !== 0 ? sd : a.localeCompare(b);
+  });
+
+  const out: string[] = [...BARREL_HEADER];
+  let currentSection: Section | -1 = -1;
+  let inObjectGroup = false;
+
+  for (const modulePath of sortedModules) {
+    const section = moduleSection(modulePath);
+    const exports = moduleMap.get(modulePath);
+    if (!exports) continue;
+    const isObject = OBJECT_MODULES.has(modulePath);
+
+    // Section transition
+    if (section !== currentSection) {
+      if (currentSection !== -1) out.push("");
+      out.push(SECTION_COMMENTS[section]);
+      currentSection = section;
+      inObjectGroup = false;
+    }
+
+    // Sub-section comments within IDS
+    if (section === Section.IDS) {
+      if (isObject && !inObjectGroup) {
+        out.push("");
+        out.push("// --- Object identifiers ---");
+        inObjectGroup = true;
+      } else if (!isObject && inObjectGroup) {
+        out.push("");
+        out.push("// --- More IDS types and constants ---");
+        inObjectGroup = false;
+      }
+    }
+
+    if (exports.types.length > 0) {
+      out.push(formatExportLine("export type", exports.types, modulePath));
+    }
+    if (exports.values.length > 0) {
+      out.push(formatExportLine("export", exports.values, modulePath));
+    }
+  }
+
+  out.push("");
+  return out;
+}
+
+/**
+ * Generates the bg2/index.ts barrel file by scanning all sibling modules
+ * and extracting their exported names.
+ */
+export function generateBarrelFile(bg2Dir: string): void {
+  const moduleMap = buildModuleMap(bg2Dir);
+  const output = buildBarrelOutput(moduleMap);
+
+  const outputPath = path.join(bg2Dir, "index.ts");
+  fs.writeFileSync(outputPath, output.join("\n"), "utf-8");
+  log(`Barrel file written to ${outputPath} (${moduleMap.size} modules)`);
+}

package/scripts/ensure-iesdp.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# Shared script to ensure IESDP repository is cloned and on the correct branch.
+# Source this from other scripts: source scripts/ensure-iesdp.sh
+
+set -eu -o pipefail
+
+ensure_iesdp() {
+    local ext_dir="external"
+    local iesdp_dir="$ext_dir/iesdp"
+    local repo="BGforgeNet/iesdp"
+
+    if [[ ! -d "$iesdp_dir" ]]; then
+        mkdir -p "$ext_dir"
+        git clone "https://github.com/$repo/" "$iesdp_dir" >&2 || { echo "Failed to clone IESDP repository" >&2; exit 1; }
+        git -C "$iesdp_dir" checkout ielib >&2 || { echo "Failed to checkout ielib branch" >&2; exit 1; }
+    fi
+
+    echo "$iesdp_dir"
+}

package/scripts/ts-update.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+# Runs the TypeScript update script to generate action/trigger declarations.
+
+set -xeu -o pipefail
+
+source "$(dirname "$0")/ensure-iesdp.sh"
+
+iesdp_dir=$(ensure_iesdp)
+
+pnpm exec tsx scripts/ts-update.ts \
+    "$iesdp_dir/_data/actions" \
+    src/bg2/actions.d.ts \
+    "$iesdp_dir/scripting/triggers/bg2triggers.htm" \
+    src/bg2/triggers.d.ts