genshin-ts-touyu 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 josStorer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+<p align="center">
+<img width="256" height="256" alt="logo" src="https://github.com/user-attachments/assets/a1000ae8-8633-449f-9b90-fd3c5da8c4a2" />
+</p>
+<h1 align="center">Genshin-TS</h1>
+
+<div align="center">
+
+Use TypeScript to develop Genshin UGC (Miliastra Wonderland) projects. Full type system, practical helpers, JS-native and Unity3D-style APIs, npm ecosystem support, and an AI-friendly workflow.
+
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/TheTouYu/genshin-ts/blob/master/LICENSE)
+[![release](https://img.shields.io/github/release/TheTouYu/genshin-ts.svg)](https://github.com/TheTouYu/genshin-ts/releases/latest)
+[![downloads](https://img.shields.io/npm/dm/genshin-ts-touyu.svg)](https://www.npmjs.com/package/genshin-ts-touyu)
+[![typescript](https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+English · [简体中文](README_ZH.md)
+
+[Docs](https://gsts.moe) · [Intro Video](https://www.youtube.com/watch?v=kEACvJzHwr0) · [Template Guide & Usage Details](create-genshin-ts/templates/start/README.md)
+
+</div>
+
+## Introduction
+
+Genshin-TS (gsts) is a toolchain for building Miliastra Wonderland projects in TypeScript. It focuses on a code-first experience with controllable node-graph semantics, supporting compilation, injection, debugging, optimization, parallel builds, and incremental builds.
+
+https://github.com/user-attachments/assets/0f2ec8af-c753-4c54-940c-8147ec856635
+
+## Quick Start
+
+```bash
+npm create genshin-ts-touyu@latest
+```
+
+genshin-ts-touyu includes a TypeScript plugin for more advanced TypeScript support enhancements. It is optional (disabling it does not affect functionality and developer experience), but recommended. See:
+[https://gsts.moe/doc/quick-start/install.html#typescript-plugin](https://gsts.moe/doc/quick-start/install.html#typescript-plugin)
+
+Then in the template:
+
+```bash
+npm install
+npm run dev
+```
+
+For detailed usage and constraints, see the template guide and docs:
+- [`create-genshin-ts/templates/start/README.md`](create-genshin-ts/templates/start/README.md)
+- [https://gsts.moe](https://gsts.moe)
+
+## Highlights
+
+- TS -> NodeGraph compilation: event entry points, control flow, reusable functions, and client-side node graphs (124 nodes).
+- Full type hints with Chinese/English aliases: events, functions, APIs, entity subtypes.
+- `g.server(...).on(...)` chaining, multi-entry merge by identical ID.
+- `gstsServer*` function compilation (reusable logic, controlled returns).
+- JS-style timers: `setTimeout` / `setInterval` + closure capture + name pools + dispatch aggregation.
+- Compile-time optimizations: constant precompute, dead node removal, local variable reuse.
+- Readable IR JSON for debugging and further processing.
+- CLI toolchain: incremental builds, injection safety checks, map discovery, auto backups.
+- Custom ESLint rules to surface semantic constraints early.
+- Built-in prefab/resource ID support.
+
+## Compilation Pipeline and Outputs
+
+Pipeline:
+1. TS -> `.gs.ts` (node function call form)
+2. `.gs.ts` -> IR `.json` (nodes and connections)
+3. IR -> `.gia` (injectable output)
+
+Outputs are written to `dist/` by default. `.gs.ts` and `.json` are the primary debugging entry points.
+
+## Key Optimizations
+
+Enabled by default (can be disabled in `gsts.config.ts`):
+- `precompileExpression`: precompute literal-only expressions.
+- `removeUnusedNodes`: remove unused exec/data nodes.
+- `timerPool`: timer name pools to avoid collisions.
+- `timerDispatchAggregate`: aggregate timer dispatch to reduce graph complexity.
+
+## How to Use
+
+- **Template**: `npm create genshin-ts-touyu@latest` (recommended; TypeScript plugin guidance: [https://gsts.moe/doc/quick-start/install.html#typescript-plugin](https://gsts.moe/doc/quick-start/install.html#typescript-plugin))
+- **As a dependency**: `npm i genshin-ts-touyu` and call compiler/injector APIs in your project
+- **Global CLI**: `npm install -g genshin-ts-touyu`, then use `gsts` for compile/inject
+
+## Constraints (Overview)
+
+- Only a supported TS subset (no Promise/async/recursion).
+- Conditions must be boolean.
+- `gstsServer*` allows only a single trailing return.
+- `console.log` supports only one argument (rewritten to `print(str(...))`).
+- Native `Object.*` / `JSON.*` are generally unavailable in node-graph scope.
+
+See the template guide for the full list and best practices.
+
+## Detailed Usage & AI Guidance
+
+- Template guide: `create-genshin-ts/templates/start/README.md`
+- AI guidance: `create-genshin-ts/templates/start/CLAUDE.md` / `create-genshin-ts/templates/start/AGENTS.md`
+- Function/event notes: `node_modules/genshin-ts-touyu/dist/src/definitions/`
+
+## TODO (Some items may be dropped based on feasibility; in no particular order)
+
+- Improve CI pipeline
+- Client-side node graph support (124 nodes, full arithmetic/query/execution DSL)
+- Improve documentation site
+- Signal and struct definitions with parameter passing (generic parameter type hints)
+- Auto-detect node graph limit overflow (3000)
+- Auto re-inject on external map save detection
+- `g.scene()` programmatic scene definition support
+- Auto variable mounting support
+- Node graph JSON visual previewer
+- Programmatic struct and global timer definitions
+- More `// @gsts:` decorator optimization flags, e.g., local precompile toggle
+- `await delay` support? (highly uncertain)
+- GIA to TypeScript conversion support
+- npm library development template
+- Generate JS source maps for better error tracing
+- Fix cross-file duplicate ID level cache issues
+- JSX component development abstraction
+- Expand examples
+- Simplify `{}` style 3D vector array inference
+- Extract custom prefab IDs from GIL directly into project
+- VFX, sound, and other resource IDs
+
+## Special Thanks
+
+- https://github.com/Wu-Yijun/Genshin-Impact-Miliastra-Wonderland-Code-Node-Editor-Pack
+
+- Before discovering this project, I spent nearly a month reversing GIA/GIL; their approach was more complete. I integrated it as a third-party module and merged some of my reverse-engineered data.
+
+- The work is excellent and MIT-licensed. Please consider supporting the project as well.

package/bin/gsts.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/src/cli/gsts.js'

package/configs/eslint/full.mjs

@@ -0,0 +1,109 @@
+import eslint from '@eslint/js'
+import tseslint from '@typescript-eslint/eslint-plugin'
+import tsparser from '@typescript-eslint/parser'
+import prettierConfig from 'eslint-config-prettier'
+import prettier from 'eslint-plugin-prettier'
+import gsts from 'genshin-ts-touyu/eslint'
+import { gstsDslGlobals } from 'genshin-ts-touyu/eslint.globals.mjs'
+
+export default [
+  {
+    ignores: ['dist/**', 'out/**', 'node_modules/**']
+  },
+
+  eslint.configs.recommended,
+
+  // TypeScript 文件配置
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+        project: true
+      },
+      globals: {
+        console: 'readonly',
+        process: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        AbortController: 'readonly',
+        AbortSignal: 'readonly',
+        ...gstsDslGlobals
+      }
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+      prettier: prettier,
+      gsts
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      ...tseslint.configs['recommended-requiring-type-checking'].rules,
+      ...gsts.configs.recommended.rules,
+
+      // 代码质量规则
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/triple-slash-reference': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/ban-ts-comment': [
+        'error',
+        {
+          'ts-ignore': 'allow-with-description',
+          'ts-nocheck': 'allow-with-description'
+        }
+      ],
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_'
+        }
+      ],
+      '@typescript-eslint/no-non-null-assertion': 'off',
+
+      // this 安全规则
+      '@typescript-eslint/no-this-alias': ['error'],
+      '@typescript-eslint/unbound-method': ['error'],
+      'no-invalid-this': 'off', // 关闭基础规则
+      '@typescript-eslint/no-invalid-this': 'error', // 使用 TS 版本
+      'no-redeclare': 'off',
+      '@typescript-eslint/no-redeclare': 'error',
+
+      // 通用规则
+      'no-console': 'off',
+      'no-debugger': 'warn',
+      'prefer-const': 'off',
+      'no-var': 'error',
+
+      // Prettier 集成
+      ...prettierConfig.rules,
+      'prettier/prettier': 'error'
+    }
+  },
+
+  // JavaScript 文件配置（如配置文件等）
+  {
+    files: ['**/*.js', '**/*.mjs'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        console: 'readonly',
+        process: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly'
+      }
+    },
+    plugins: {
+      prettier: prettier
+    },
+    rules: {
+      'no-console': 'off',
+      'prettier/prettier': 'error'
+    }
+  }
+]

package/configs/eslint/recommended.mjs

@@ -0,0 +1,27 @@
+import tsparser from '@typescript-eslint/parser'
+import gsts from 'genshin-ts-touyu/eslint'
+import { gstsDslGlobals } from 'genshin-ts-touyu/eslint.globals.mjs'
+
+export default [
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+        project: true
+      },
+      globals: {
+        ...gstsDslGlobals
+      }
+    },
+    plugins: {
+      gsts
+    },
+    rules: {
+      ...gsts.configs.recommended.rules,
+      'prefer-const': 'off'
+    }
+  }
+]

package/configs/ts-plugin/index.cjs

@@ -0,0 +1,199 @@
+/**
+ * gsts tsserver plugin:
+ * suppress TS2538 ("Type X cannot be used as an index type")
+ * only for bigint/int-like index expressions inside:
+ * - g.server().on/onSignal handlers
+ * - top-level gstsServer* function bodies
+ */
+
+function init(modules) {
+  const ts = modules.typescript
+
+  function collectGImportNames(sourceFile) {
+    const names = new Set()
+    for (const stmt of sourceFile.statements) {
+      if (!ts.isImportDeclaration(stmt)) continue
+      if (!stmt.moduleSpecifier || !ts.isStringLiteral(stmt.moduleSpecifier)) continue
+      const spec = stmt.moduleSpecifier.text
+      if (spec !== 'genshin-ts-touyu/runtime/core' && spec !== 'genshin-ts-touyu/runtime/core.js') continue
+      const clause = stmt.importClause
+      const bindings = clause && clause.namedBindings
+      if (!bindings || !ts.isNamedImports(bindings)) continue
+      for (const e of bindings.elements) {
+        const importName = e.propertyName ? e.propertyName.text : e.name.text
+        if (importName === 'g') names.add(e.name.text)
+      }
+    }
+    if (!names.size) names.add('g')
+    return names
+  }
+
+  function inRange(pos, node, sourceFile) {
+    return pos >= node.getStart(sourceFile, false) && pos < node.getEnd()
+  }
+
+  function findNodeAtPos(sourceFile, pos) {
+    let best = sourceFile
+    const visit = (node) => {
+      if (!inRange(pos, node, sourceFile)) return
+      best = node
+      ts.forEachChild(node, visit)
+    }
+    visit(sourceFile)
+    return best
+  }
+
+  function findAncestor(node, pred) {
+    let cur = node
+    while (cur) {
+      if (pred(cur)) return cur
+      cur = cur.parent
+    }
+    return undefined
+  }
+
+  function hasBigIntLikeConstituent(type, checker) {
+    if (!type) return false
+    if (type.flags & ts.TypeFlags.Union) {
+      return type.types.some((t) => hasBigIntLikeConstituent(t, checker))
+    }
+    if (type.flags & ts.TypeFlags.Intersection) {
+      return type.types.some((t) => hasBigIntLikeConstituent(t, checker))
+    }
+    if ((type.flags & ts.TypeFlags.BigIntLike) !== 0) return true
+    const s = checker.typeToString(type)
+    return s === 'IntValue' || s === 'int' || s === 'bigint'
+  }
+
+  function unwrapChainBase(expr) {
+    let cur = expr
+    while (
+      ts.isCallExpression(cur) &&
+      ts.isPropertyAccessExpression(cur.expression) &&
+      (cur.expression.name.text === 'on' || cur.expression.name.text === 'onSignal')
+    ) {
+      cur = cur.expression.expression
+    }
+    return cur
+  }
+
+  function isServerHandlerFunction(fnNode, gNames) {
+    const parent = fnNode.parent
+    if (!parent || !ts.isCallExpression(parent)) return false
+    if (parent.arguments.length < 2 || parent.arguments[1] !== fnNode) return false
+    if (!ts.isPropertyAccessExpression(parent.expression)) return false
+    const method = parent.expression.name.text
+    if (method !== 'on' && method !== 'onSignal') return false
+
+    const base = unwrapChainBase(parent.expression.expression)
+    if (!ts.isCallExpression(base)) return false
+    if (!ts.isPropertyAccessExpression(base.expression)) return false
+    if (base.expression.name.text !== 'server') return false
+    if (!ts.isIdentifier(base.expression.expression)) return false
+    return gNames.has(base.expression.expression.text)
+  }
+
+  function isInGServerScope(node, gNames) {
+    let cur = node
+    while (cur) {
+      if (
+        (ts.isArrowFunction(cur) ||
+          ts.isFunctionExpression(cur) ||
+          ts.isFunctionDeclaration(cur)) &&
+        isServerHandlerFunction(cur, gNames)
+      ) {
+        return true
+      }
+      cur = cur.parent
+    }
+    return false
+  }
+
+  function isTopLevelFunctionDeclaration(node) {
+    return ts.isFunctionDeclaration(node) && !!node.name && ts.isSourceFile(node.parent)
+  }
+
+  function isTopLevelGstsServerVarInitializer(node) {
+    if (!(ts.isArrowFunction(node) || ts.isFunctionExpression(node))) return false
+    const decl = node.parent
+    if (!decl || !ts.isVariableDeclaration(decl)) return false
+    if (decl.initializer !== node) return false
+    if (!ts.isIdentifier(decl.name)) return false
+    const list = decl.parent
+    if (!list || !ts.isVariableDeclarationList(list)) return false
+    const stmt = list.parent
+    if (!stmt || !ts.isVariableStatement(stmt)) return false
+    return ts.isSourceFile(stmt.parent)
+  }
+
+  function isGstsServerRootFunction(node) {
+    if (isTopLevelFunctionDeclaration(node)) return node.name.text.startsWith('gstsServer')
+    if (isTopLevelGstsServerVarInitializer(node)) {
+      const decl = node.parent
+      return ts.isIdentifier(decl.name) && decl.name.text.startsWith('gstsServer')
+    }
+    return false
+  }
+
+  function isInGstsServerScope(node) {
+    let cur = node
+    while (cur) {
+      if (
+        (ts.isArrowFunction(cur) ||
+          ts.isFunctionExpression(cur) ||
+          ts.isFunctionDeclaration(cur)) &&
+        isGstsServerRootFunction(cur)
+      ) {
+        return true
+      }
+      cur = cur.parent
+    }
+    return false
+  }
+
+  function shouldSuppress2538(diagnostic, sourceFile, checker) {
+    if (!diagnostic || diagnostic.code !== 2538) return false
+    if (!diagnostic.file || typeof diagnostic.start !== 'number') return false
+    const pos = diagnostic.start
+    const gNames = collectGImportNames(sourceFile)
+    const nodeAtPos = findNodeAtPos(sourceFile, pos)
+
+    const elem = findAncestor(
+      nodeAtPos,
+      (n) =>
+        ts.isElementAccessExpression(n) &&
+        !!n.argumentExpression &&
+        inRange(pos, n.argumentExpression, sourceFile)
+    )
+    if (!elem || !elem.argumentExpression) return false
+    if (!isInGServerScope(elem, gNames) && !isInGstsServerScope(elem)) return false
+
+    const indexType = checker.getTypeAtLocation(elem.argumentExpression)
+    return hasBigIntLikeConstituent(indexType, checker)
+  }
+
+  function create(info) {
+    const languageService = info.languageService
+    const proxy = Object.create(null)
+    for (const key of Object.keys(languageService)) {
+      proxy[key] = languageService[key].bind(languageService)
+    }
+
+    proxy.getSemanticDiagnostics = (fileName) => {
+      const base = languageService.getSemanticDiagnostics(fileName)
+      if (!Array.isArray(base) || base.length === 0) return base
+      const program = languageService.getProgram()
+      if (!program) return base
+      const sourceFile = program.getSourceFile(fileName)
+      if (!sourceFile) return base
+      const checker = program.getTypeChecker()
+      return base.filter((d) => !shouldSuppress2538(d, sourceFile, checker))
+    }
+
+    return proxy
+  }
+
+  return { create }
+}
+
+module.exports = init

package/configs/ts-plugin/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "genshin-ts-touyu-ts-plugin",
+  "private": true,
+  "type": "commonjs",
+  "main": "./index.cjs"
+}

package/configs/tsconfig/base.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "plugins": [{ "name": "genshin-ts-touyu/configs/ts-plugin" }],
+    "strict": true,
+    "types": ["node"],
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "skipLibCheck": true
+  }
+}

package/configs/tsconfig/eslint.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": ["**/*.ts", "**/*.tsx"]
+}

package/dist/src/cli/checks.d.ts

@@ -0,0 +1,4 @@
+import { type Lang } from '../i18n/index.js';
+type CheckKey = 'update' | 'notice';
+export declare function maybeCheckRemoteMarkdown(key: CheckKey, lang: Lang): Promise<void>;
+export {};

package/dist/src/cli/checks.js

@@ -0,0 +1,68 @@
+import { initCliI18n } from '../i18n/index.js';
+import { ensureDataDirs } from './data.js';
+import { renderMarkdownToAnsi } from './markdown_render.js';
+import { fetchText } from './net.js';
+import { shouldShowNotice, splitMarkdownFrontmatter } from './notice_frontmatter.js';
+import { getSelfVersion } from './pkg.js';
+import { loadState, saveState } from './state.js';
+import { createUi } from './ui.js';
+import { findLatestUpdate } from './update_changelog.js';
+const ui = createUi();
+const URLS = {
+    update: {
+        'en-US': 'https://github.com/TheTouYu/genshin-ts/raw/refs/heads/master/Changelog.md',
+        'zh-CN': 'https://github.com/TheTouYu/genshin-ts/raw/refs/heads/master/Changelog_ZH.md'
+    },
+    notice: {
+        'en-US': 'https://github.com/TheTouYu/genshin-ts/raw/refs/heads/master/Announcement.md',
+        'zh-CN': 'https://github.com/TheTouYu/genshin-ts/raw/refs/heads/master/Announcement_ZH.md'
+    }
+};
+function getBucket(state, key) {
+    return key === 'update' ? state.updateCheck : state.noticeCheck;
+}
+function setBucket(state, key, next) {
+    if (key === 'update')
+        state.updateCheck = next;
+    else
+        state.noticeCheck = next;
+}
+export async function maybeCheckRemoteMarkdown(key, lang) {
+    ensureDataDirs();
+    const { t } = initCliI18n(lang);
+    const state = loadState();
+    const bucket = getBucket(state, key) ?? {};
+    const lastAt = bucket.lastAt ?? 0;
+    const cooldownMs = 2 * 3600 * 1000;
+    const cooledDown = Date.now() - lastAt >= cooldownMs;
+    const streak = cooledDown ? 0 : (bucket.streak ?? 0);
+    const now = Date.now();
+    const minIntervalMs = 5 * 60 * 1000;
+    if (now - lastAt < minIntervalMs)
+        return;
+    if (streak >= 3)
+        return;
+    setBucket(state, key, { lastAt: now, streak: streak + 1 });
+    saveState(state);
+    const url = URLS[key][lang];
+    ui.info(key === 'update' ? t('checkUpdate') : t('checkNotice'));
+    const md = await fetchText(url);
+    const rendered = (() => {
+        if (key === 'notice') {
+            const { meta, body } = splitMarkdownFrontmatter(md);
+            const ver = getSelfVersion();
+            if (!shouldShowNotice(meta, Date.now(), ver))
+                return '';
+            return renderMarkdownToAnsi(body);
+        }
+        const hit = findLatestUpdate(md, getSelfVersion());
+        if (!hit)
+            return '';
+        ui.warn(`${t('updateFound')}: v${hit.latest}`);
+        return renderMarkdownToAnsi(hit.snippet);
+    })();
+    if (rendered.length) {
+        process.stdout.write(rendered + '\n');
+    }
+}
+//# sourceMappingURL=checks.js.map

package/dist/src/cli/checks.js.map

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

package/dist/src/cli/data.d.ts

@@ -0,0 +1,6 @@
+export declare function getDataDir(): string;
+export declare function ensureDataDirs(): {
+    dataDir: string;
+    backupsDir: string;
+};
+export declare function getStatePath(): string;

package/dist/src/cli/data.js

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export function getDataDir() {
+    const appData = process.env.APPDATA;
+    if (appData && appData.length)
+        return path.join(appData, 'genshin-ts-touyu');
+    // fallback (rare on Windows): ~/.config like style
+    return path.join(os.homedir(), '.genshin-ts-touyu');
+}
+export function ensureDataDirs() {
+    const dataDir = getDataDir();
+    const backupsDir = path.join(dataDir, 'backups');
+    fs.mkdirSync(backupsDir, { recursive: true });
+    return { dataDir, backupsDir };
+}
+export function getStatePath() {
+    return path.join(getDataDir(), 'state.json');
+}
+//# sourceMappingURL=data.js.map

package/dist/src/cli/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../../src/cli/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;IACnC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;IAC5E,mDAAmD;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,mBAAmB,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAChD,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC,CAAA;AAC9C,CAAC"}

package/dist/src/cli/gil_paths.d.ts

@@ -0,0 +1,21 @@
+import type { GstsGameRegion, GstsInjectConfig } from '../compiler/gsts_config.js';
+export type ResolvedGilTarget = {
+    region: GstsGameRegion;
+    beyondLocalRoot: string;
+    playerId: number;
+    saveLevelDir: string;
+    mapId: number;
+    gilPath: string;
+};
+export type ResolvedGilFolder = {
+    region: GstsGameRegion;
+    beyondLocalRoot: string;
+    playerId: number;
+    saveLevelDir: string;
+};
+export declare function detectGameRegion(): {
+    region: GstsGameRegion;
+    root: string;
+} | null;
+export declare function resolveGilTarget(cfg: GstsInjectConfig): ResolvedGilTarget;
+export declare function resolveGilFolder(cfg: GstsInjectConfig): ResolvedGilFolder;