poi-plugin-item-improvement2-beta 1.0.26 → 1.0.28

package/README.md

@@ -1,27 +1,39 @@
-# Plugin-Item-Improvement
-Show improvable items of the day
-#### Usage
-Put the folder into /path/to/poi/resources/app/plugins.
+# Plugin Item Improvement
 
-#### Data source
-The plugin makes use of equipment improvement data from [Akashi List](https://akashi-list.me/).
+Poi plugin for viewing KanColle equipment improvement schedules, complete recipe routes, costs, and required materials.
 
-## Publishing the beta package
+## Usage
 
-The beta package uses a separate npm package name while keeping the source tree on the official namespace.
+Install the plugin through Poi, or place the package in Poi's plugin directory.
+
+Improvement data and use-item assets are supplied by the local npm dependency `@sakura2333/kancolle-data`; the plugin does not download GitHub data at runtime.
+
+## Development
 
 ```bash
-npm run publish:beta:dry-run
-npm run publish:beta
+npm ci --include=dev
+npm test
+npm pack --dry-run
 ```
 
-`publish:beta` temporarily replaces every runtime occurrence of
-`poi-plugin-item-improvement2-beta` with `poi-plugin-item-improvement2-beta-beta`, runs
-`npm publish`, and restores the original files even when publishing fails.
-Arguments after `--` are forwarded to `npm publish`.
+The committed lockfile keeps the legacy Poi transpilation toolchain reproducible. CI tests both the locked minimum-compatible data package and the latest compatible data package.
 
-## Data package
+## Publishing
+
+Publish a compatible `@sakura2333/kancolle-data` release before publishing a plugin version that depends on it.
+
+Official package:
+
+```bash
+npm test
+npm publish --registry=https://registry.npmjs.org/
+```
+
+Beta package:
+
+```bash
+npm run publish:beta:dry-run
+npm run publish:beta
+```
 
-Improvement data and use-item PNG assets are supplied by the versioned npm dependency
-`@sakura2333/kancolle-data`. The plugin no longer downloads data from GitHub at runtime.
-Publish the data package before publishing a plugin version that depends on it.
+The beta script temporarily changes the package and runtime namespace to `poi-plugin-item-improvement2-beta-beta`, publishes it, and restores the source tree even when publication fails.

package/i18n/en-US.json

@@ -58,5 +58,6 @@
   "changelog_1_0_22_reopen_notes": "A What’s New button was added to the toolbar so release notes can be reopened at any time.",
   "changelog_1_0_21_stable_data": "Improvement information now loads and updates more reliably.",
   "changelog_1_0_21_separate_routes": "Improvement routes with different materials, costs, or upgrade targets are now shown in separate tables.",
-  "changelog_1_0_21_tamanami_route": "Added Tamanami Kai Ni’s dedicated material route and kept it separate from the normal route."
+  "changelog_1_0_21_tamanami_route": "Added Tamanami Kai Ni’s dedicated material route and kept it separate from the normal route.",
+  "changelog_1_0_27_data_safety": "Improved data safety checks so incomplete or incompatible improvement information is rejected instead of being displayed incorrectly."
 }

package/i18n/ja-JP.json

@@ -58,5 +58,6 @@
   "changelog_1_0_22_reopen_notes": "ツールバーに「更新履歴」ボタンを追加し、いつでも変更内容を確認できるようにしました。",
   "changelog_1_0_21_stable_data": "改修情報の読み込みと更新をより安定させました。",
   "changelog_1_0_21_separate_routes": "必要装備、資材、更新先が異なる改修ルートを別々の表で表示するようにしました。",
-  "changelog_1_0_21_tamanami_route": "玉波改二専用の改修素材ルートを追加し、通常ルートと混在しないようにしました。"
+  "changelog_1_0_21_tamanami_route": "玉波改二専用の改修素材ルートを追加し、通常ルートと混在しないようにしました。",
+  "changelog_1_0_27_data_safety": "不完全または互換性のない改修情報を誤って表示しないよう、データ確認を強化しました。"
 }

package/i18n/zh-CN.json

@@ -58,5 +58,6 @@
   "changelog_1_0_22_reopen_notes": "工具栏新增“更新日志”按钮，可随时回看版本变化。",
   "changelog_1_0_21_stable_data": "改修信息的加载和更新更加稳定。",
   "changelog_1_0_21_separate_routes": "材料、资材或升级目标不同的改修路线现在会分表展示。",
-  "changelog_1_0_21_tamanami_route": "补充玉波改二专属的改修材料路线，避免与普通路线混在一起。"
+  "changelog_1_0_21_tamanami_route": "补充玉波改二专属的改修材料路线，避免与普通路线混在一起。",
+  "changelog_1_0_27_data_safety": "加强改修资料完整性检查，遇到不完整或不兼容的资料时会拒绝加载，避免显示错误内容。"
 }

package/i18n/zh-TW.json

@@ -58,5 +58,6 @@
   "changelog_1_0_22_reopen_notes": "工具列新增「更新日誌」按鈕，可隨時回看版本變更。",
   "changelog_1_0_21_stable_data": "改修資訊的載入與更新更加穩定。",
   "changelog_1_0_21_separate_routes": "材料、資材或升級目標不同的改修路線現在會分表顯示。",
-  "changelog_1_0_21_tamanami_route": "補充玉波改二專屬的改修材料路線，避免與一般路線混在一起。"
+  "changelog_1_0_21_tamanami_route": "補充玉波改二專屬的改修材料路線，避免與一般路線混在一起。",
+  "changelog_1_0_27_data_safety": "加強改修資料完整性檢查，遇到不完整或不相容的資料時會拒絕載入，避免顯示錯誤內容。"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "poi-plugin-item-improvement2-beta",
-  "version": "1.0.26",
-  "description": "use new data source",
+  "version": "1.0.28",
+  "description": "View KanColle equipment improvement schedules, routes, costs, and required materials in Poi",
   "main": "index.js",
   "scripts": {
     "prepack": "poi-util-transpile",
@@ -34,7 +34,7 @@
   "dependencies": {
     "dom-to-image": "^2.6.0",
     "react-numeric-input": "^2.2.3",
-    "@sakura2333/kancolle-data": "^0.1.0"
+    "@sakura2333/kancolle-data": ">=0.1.0 <0.3.0"
   },
   "devDependencies": {
     "babel-eslint": "^10.0.1",
@@ -63,10 +63,6 @@
     "views/**/*.js",
     "assets/**/*",
     "i18n/*.json",
-    "scripts/publish-beta.js",
-    "tests/improvement-data.test.js",
-    "CHANGELOG.md",
-    "README.md",
-    "REFACTOR_NOTES.md"
+    "README.md"
   ]
 }

package/views/changelog.js

@@ -13,6 +13,9 @@ const CHANGELOG_BASELINE_VERSION = '1.0.20'; // Keep in-app notes focused on use
 
 exports.CHANGELOG_BASELINE_VERSION = CHANGELOG_BASELINE_VERSION;
 const CHANGELOG = [{
+  version: '1.0.27',
+  items: ['changelog_1_0_27_data_safety']
+}, {
   version: '1.0.26',
   items: ['changelog_1_0_26_useitem_icon']
 }, {

package/views/data-package.js

@@ -1,14 +1,15 @@
 "use strict";
 
 exports.__esModule = true;
-exports.MAX_SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = exports.DATA_PACKAGE_NAME = exports.getUseitemIconPath = exports.getImprovementDataPaths = exports.getDataPackageManifest = void 0;
+exports.validateSchemaVersion = exports.SUPPORTED_IMPROVEMENT_LIST_SCHEMA_VERSION = exports.SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = exports.DATA_PACKAGE_NAME = exports.getUseitemIconPath = exports.getImprovementDataPaths = exports.getDataPackageManifest = void 0;
 
 var _fs = _interopRequireDefault(require("fs"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 const PACKAGE_NAME = '@sakura2333/kancolle-data';
-const SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = 3;
+const IMPROVEMENT_SCHEMA_VERSION = 3;
+const IMPROVEMENT_LIST_SCHEMA_VERSION = 2;
 let dataPackage = null;
 let manifest = null;
 
@@ -26,6 +27,14 @@ function loadDataPackage() {
   return dataPackage;
 }
 
+function requireExactSchema(value, expected, label) {
+  const schemaVersion = Number(value);
+
+  if (!Number.isInteger(schemaVersion) || schemaVersion !== expected) {
+    throw new Error(`Unsupported ${label} schema ${value}; supported version is ${expected}`);
+  }
+}
+
 function readManifest() {
   if (manifest) return manifest;
   const pkg = loadDataPackage();
@@ -41,8 +50,10 @@ function readManifest() {
     throw new Error(`${PACKAGE_NAME} does not contain the improvement dataset`);
   }
 
-  if (Number(improvement.schemaVersion) > SUPPORTED_IMPROVEMENT_SCHEMA_VERSION) {
-    throw new Error(`Unsupported improvement schema ${improvement.schemaVersion}; ` + `maximum supported is ${SUPPORTED_IMPROVEMENT_SCHEMA_VERSION}`);
+  requireExactSchema(improvement.schemaVersion, IMPROVEMENT_SCHEMA_VERSION, 'improvement detail');
+
+  if (improvement.listSchemaVersion != null) {
+    requireExactSchema(improvement.listSchemaVersion, IMPROVEMENT_LIST_SCHEMA_VERSION, 'improvement list');
   }
 
   return manifest;
@@ -60,6 +71,10 @@ const getImprovementDataPaths = () => {
     throw new Error(`${PACKAGE_NAME} improvement paths are incomplete`);
   }
 
+  if (!_fs.default.existsSync(pkg.improvement.listPath) || !_fs.default.existsSync(pkg.improvement.detailPath)) {
+    throw new Error(`${PACKAGE_NAME} improvement files are missing`);
+  }
+
   return {
     listPath: pkg.improvement.listPath,
     detailPath: pkg.improvement.detailPath
@@ -76,5 +91,9 @@ const getUseitemIconPath = id => {
 exports.getUseitemIconPath = getUseitemIconPath;
 const DATA_PACKAGE_NAME = PACKAGE_NAME;
 exports.DATA_PACKAGE_NAME = DATA_PACKAGE_NAME;
-const MAX_SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = SUPPORTED_IMPROVEMENT_SCHEMA_VERSION;
-exports.MAX_SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = MAX_SUPPORTED_IMPROVEMENT_SCHEMA_VERSION;
+const SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = IMPROVEMENT_SCHEMA_VERSION;
+exports.SUPPORTED_IMPROVEMENT_SCHEMA_VERSION = SUPPORTED_IMPROVEMENT_SCHEMA_VERSION;
+const SUPPORTED_IMPROVEMENT_LIST_SCHEMA_VERSION = IMPROVEMENT_LIST_SCHEMA_VERSION;
+exports.SUPPORTED_IMPROVEMENT_LIST_SCHEMA_VERSION = SUPPORTED_IMPROVEMENT_LIST_SCHEMA_VERSION;
+const validateSchemaVersion = requireExactSchema;
+exports.validateSchemaVersion = validateSchemaVersion;

package/views/improvement-data-source.js

@@ -26,6 +26,10 @@ function validateListData(data) {
     throw new Error('Invalid improvement list data');
   }
 
+  if (Number(data.metadata.schemaVersion) !== 2 || !Array.isArray(data.metadata.rowSchema) || data.metadata.rowSchema.length !== 2 || data.metadata.rowSchema[0] !== 'itemId' || data.metadata.rowSchema[1] !== 'assistantTexts') {
+    throw new Error('Unsupported improvement list schema');
+  }
+
   data.data.forEach((rows, viewIndex) => {
     if (!Array.isArray(rows)) {
       throw new Error(`Invalid improvement list view: ${viewIndex}`);

package/CHANGELOG.md

@@ -1,107 +0,0 @@
-# Changelog
-
-All notable changes to `poi-plugin-item-improvement2-beta` are documented here.
-
-## [Unreleased]
-
-### Planned
-
-- Add consumer views for equipment acquisition sources and special ship bonuses from `@sakura2333/kancolle-data`.
-- Remove the remaining local compatibility icon after the shared data package contains it.
-
-## [1.0.26] - 2026-06-28
-
-### Fixed
-
-- Ensured the local use-item 71 compatibility PNG is explicitly included in official and beta npm packages.
-- Re-encoded the unchanged icon pixels so Git patches and repository updates physically carry the binary asset instead of relying on an existing working-tree copy.
-
-### Changed
-
-- Added an explicit npm `files` allowlist covering runtime JavaScript, localized resources, styles, and all icon assets.
-
-### Validation
-
-- Added a package dry-run assertion that fails when `assets/icon/71.png` is absent from the npm tarball file list.
-- Added PNG signature validation for the compatibility icon.
-
-## [1.0.25] - 2026-06-28
-
-### Changed
-
-- Rewrote the in-app release notes to describe user-visible behavior instead of npm, schema, repository, and packaging implementation details.
-- Added localized user-facing release-note copy for Simplified Chinese, Traditional Chinese, Japanese, and English.
-- Kept detailed engineering changes in this repository `CHANGELOG.md` for development and release auditing.
-
-### Validation
-
-- Added coverage that every in-app changelog key exists in all supported locales.
-- Added coverage preventing technical package terminology from leaking back into the Simplified Chinese in-app release notes.
-
-## [1.0.24] - 2026-06-28
-
-### Changed
-
-- Relaxed the shared data dependency from exact `0.1.0` to the compatible `^0.1.0` range.
-- New plugin installs and dependency refreshes can now consume automatically published `0.1.x` data-only patch releases without requiring a plugin release for every dataset refresh.
-
-### Compatibility
-
-- Data package minor/schema releases remain blocked until the plugin explicitly updates its supported dependency range and schema checks.
-- Existing installed plugins still need their dependency installation to be refreshed before npm can resolve a newer data patch.
-
-## [1.0.23] - 2026-06-28
-
-### Added
-
-- Added the versioned `@sakura2333/kancolle-data@0.1.0` runtime dependency.
-- Added a data-package adapter that exposes improvement list/detail paths and validates the supported improvement schema.
-- Added shared use-item icon lookup through the data package.
-
-### Changed
-
-- Moved improvement list data, improvement detail data, and most use-item PNG assets out of the plugin package.
-- Removed runtime GitHub data synchronization; all required data is installed locally by npm.
-- Changed official and beta builds to consume the same versioned data package.
-- Reduced the plugin tarball from the historical embedded-data size to a lightweight code package.
-- Kept the local `71.png` and generic SVG as temporary compatibility assets.
-
-### Fixed
-
-- Fixed plugin startup being dependent on GitHub Raw availability and network conditions.
-- Fixed data and PNG updates requiring duplicate copies in the Spider and plugin repositories.
-
-### Compatibility
-
-- Requires `@sakura2333/kancolle-data` with a supported improvement schema.
-- Publish the data package before publishing a plugin version that depends on it.
-
-## [1.0.22] - 2026-06-28
-
-### Added
-
-- Added a localized release-notes dialog shown once after a version change.
-- Added a toolbar entry for reopening the release notes manually.
-- Added `publish:beta` and `publish:beta:dry-run` scripts.
-
-### Changed
-
-- Beta publishing temporarily changes package and runtime namespaces to `poi-plugin-item-improvement2-beta-beta` and always restores the working tree afterward.
-
-## [1.0.21] - 2026-06-28
-
-### Added
-
-- Added separate list and detail data projections.
-- Added support for multiple independent improvement recipe routes.
-- Added the Tamanami Kai Ni assistant-specific material route.
-
-### Changed
-
-- Changed the detail UI to render one table per complete recipe route.
-- Unified list and detail assistant presentation through normalized view models.
-
-### Fixed
-
-- Fixed routes with different materials, costs, or upgrade targets sharing the first route's table header.
-- Fixed the default route and Tamanami Kai Ni route being merged back together in the UI.

package/REFACTOR_NOTES.md

@@ -1,43 +0,0 @@
-# Data package and route-aware UI
-
-## Runtime data
-
-The plugin consumes the versioned npm dependency `@sakura2333/kancolle-data`:
-
-- `improvement/list.json`: compact all + seven-day list projection.
-- `improvement/detail.nedb`: full equipment detail and recipe routes.
-- `assets/useitems/*.png`: shared use-item icons.
-
-The plugin no longer downloads GitHub files at runtime and no longer carries duplicate
-improvement datasets. `assets/icon/useitem.svg` remains the generic fallback; the legacy
-`71.png` is temporarily retained until it is present in the data package.
-
-## Responsibility boundary
-
-- Spider collects and validates sources, normalizes assistant IDs, splits concrete recipes,
-  and publishes `@sakura2333/kancolle-data`.
-- The data package exposes stable local paths and dataset manifests.
-- The plugin reads the installed package, validates the supported improvement schema, and
-  maps the data into UI view models.
-- The list page reads backend-provided `[itemId, assistantTexts]` rows.
-- The detail page displays every `improvementList[]` entry as one independent route.
-
-## Multiple route support
-
-`DetailRow` renders one table per improvement route. Each table uses its own base resources,
-stage costs, consumables, MAX target, and assistant schedule. This supports assistant-specific
-recipes such as the `玉波改二` route for `12.7cm連装砲D型改二`.
-
-## Publish order
-
-1. Build and publish `@sakura2333/kancolle-data` from the Spider repository.
-2. Install development dependencies for this plugin.
-3. Run tests and publish the official or beta plugin.
-
-```bash
-npm ci --include=dev
-npm test
-npm publish
-# or
-npm run publish:beta
-```

package/scripts/publish-beta.js

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-
-'use strict'
-
-const fs = require('fs')
-const path = require('path')
-const { spawn } = require('child_process')
-
-const ROOT = path.resolve(__dirname, '..')
-const OFFICIAL_NAME = 'poi-plugin-item-improvement2'
-const BETA_NAME = 'poi-plugin-item-improvement2-beta'
-const SELF_PATH = path.resolve(__filename)
-const SKIP_DIRECTORIES = new Set(['.git', 'node_modules'])
-const MAX_TEXT_FILE_SIZE = 5 * 1024 * 1024
-
-function isProbablyText(buffer) {
-  return !buffer.includes(0)
-}
-
-function collectFiles(directory, output = []) {
-  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-    if (entry.isDirectory() && SKIP_DIRECTORIES.has(entry.name)) continue
-
-    const absolutePath = path.join(directory, entry.name)
-    if (entry.isDirectory()) {
-      collectFiles(absolutePath, output)
-    } else if (entry.isFile()) {
-      output.push(absolutePath)
-    }
-  }
-  return output
-}
-
-function buildReplacementPlan() {
-  const replacements = []
-
-  for (const filePath of collectFiles(ROOT)) {
-    if (path.resolve(filePath) === SELF_PATH) continue
-
-    const stat = fs.statSync(filePath)
-    if (stat.size > MAX_TEXT_FILE_SIZE) continue
-
-    const original = fs.readFileSync(filePath)
-    if (!isProbablyText(original)) continue
-
-    const originalText = original.toString('utf8')
-    if (!originalText.includes(OFFICIAL_NAME)) continue
-
-    const betaText = originalText.split(OFFICIAL_NAME).join(BETA_NAME)
-    replacements.push({
-      filePath,
-      original,
-      replacement: Buffer.from(betaText, 'utf8'),
-    })
-  }
-
-  return replacements
-}
-
-function assertOfficialWorkspace() {
-  const packageJsonPath = path.join(ROOT, 'package.json')
-  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'))
-
-  if (packageJson.name !== OFFICIAL_NAME) {
-    throw new Error(
-      `Expected package.json name to be ${OFFICIAL_NAME}, got ${packageJson.name}`
-    )
-  }
-}
-
-function applyReplacementPlan(plan) {
-  for (const entry of plan) {
-    fs.writeFileSync(entry.filePath, entry.replacement)
-  }
-}
-
-function restoreReplacementPlan(plan) {
-  for (const entry of plan) {
-    fs.writeFileSync(entry.filePath, entry.original)
-  }
-}
-
-function relative(filePath) {
-  return path.relative(ROOT, filePath) || '.'
-}
-
-function runNpmPublish(args) {
-  const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm'
-
-  return new Promise((resolve, reject) => {
-    const child = spawn(npmCommand, ['publish', ...args], {
-      cwd: ROOT,
-      env: process.env,
-      stdio: 'inherit',
-    })
-
-    const forwardSignal = signal => {
-      if (!child.killed) child.kill(signal)
-    }
-
-    process.once('SIGINT', forwardSignal)
-    process.once('SIGTERM', forwardSignal)
-
-    child.once('error', error => {
-      process.removeListener('SIGINT', forwardSignal)
-      process.removeListener('SIGTERM', forwardSignal)
-      reject(error)
-    })
-
-    child.once('exit', (code, signal) => {
-      process.removeListener('SIGINT', forwardSignal)
-      process.removeListener('SIGTERM', forwardSignal)
-
-      if (signal) {
-        reject(new Error(`npm publish terminated by ${signal}`))
-      } else {
-        resolve(code == null ? 1 : code)
-      }
-    })
-  })
-}
-
-async function main() {
-  assertOfficialWorkspace()
-
-  const plan = buildReplacementPlan()
-  if (plan.length === 0) {
-    throw new Error(`No occurrences of ${OFFICIAL_NAME} were found`)
-  }
-
-  console.log(`Temporarily switching package namespace:`)
-  console.log(`  ${OFFICIAL_NAME} -> ${BETA_NAME}`)
-  console.log('Changed files:')
-  for (const entry of plan) {
-    console.log(`  - ${relative(entry.filePath)}`)
-  }
-
-  let exitCode = 1
-  applyReplacementPlan(plan)
-
-  try {
-    const betaPackage = JSON.parse(
-      fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')
-    )
-    if (betaPackage.name !== BETA_NAME) {
-      throw new Error('Temporary beta package-name replacement failed')
-    }
-
-    exitCode = await runNpmPublish(process.argv.slice(2))
-  } finally {
-    restoreReplacementPlan(plan)
-    console.log(`Restored workspace namespace to ${OFFICIAL_NAME}`)
-  }
-
-  if (exitCode !== 0) {
-    throw new Error(`npm publish exited with code ${exitCode}`)
-  }
-}
-
-main().catch(error => {
-  console.error(`[publish:beta] ${error.message}`)
-  process.exitCode = 1
-})

package/tests/improvement-data.test.js

@@ -1,271 +0,0 @@
-const assert = require('assert')
-const fs = require('fs')
-const path = require('path')
-const { execFileSync } = require('child_process')
-const {
-  buildAssistantTextByDay,
-  buildImprovementItem,
-  createShipNameResolver,
-  normalizeAssistant,
-  normalizeListProjection,
-  normalizeShipIds,
-} = require('../views/improvement-data.js')
-
-
-const {
-  CHANGELOG,
-  compareVersions,
-  getChangelogEntriesSince,
-} = require('../views/changelog.js')
-
-assert.strictEqual(compareVersions('1.0.22', '1.0.21'), 1)
-assert.strictEqual(compareVersions('1.0.21', '1.0.21'), 0)
-assert.strictEqual(compareVersions('1.0.20', '1.0.21'), -1)
-assert.deepStrictEqual(
-  getChangelogEntriesSince('1.0.21').map(entry => entry.version),
-  ['1.0.26', '1.0.25', '1.0.24', '1.0.23', '1.0.22']
-)
-assert.deepStrictEqual(
-  getChangelogEntriesSince(null).map(entry => entry.version),
-  ['1.0.26', '1.0.25', '1.0.24', '1.0.23', '1.0.22', '1.0.21']
-)
-
-const localeNames = ['zh-CN', 'zh-TW', 'ja-JP', 'en-US']
-const locales = localeNames.reduce((result, localeName) => {
-  const localePath = path.join(__dirname, '..', 'i18n', `${localeName}.json`)
-  result[localeName] = JSON.parse(fs.readFileSync(localePath, 'utf8'))
-  return result
-}, {})
-
-const changelogKeys = CHANGELOG.reduce(
-  (keys, entry) => keys.concat(entry.items),
-  []
-)
-
-localeNames.forEach(localeName => {
-  changelogKeys.forEach(key => {
-    assert.strictEqual(
-      typeof locales[localeName][key],
-      'string',
-      `${localeName} is missing changelog entry ${key}`
-    )
-    assert.ok(
-      locales[localeName][key].trim().length > 0,
-      `${localeName} has an empty changelog entry ${key}`
-    )
-  })
-})
-
-const technicalTerms = [
-  '@sakura2333/kancolle-data',
-  'npm',
-  'Schema',
-  '0.1.x',
-  'PNG',
-  'GitHub',
-]
-const simplifiedChineseNotes = changelogKeys
-  .map(key => locales['zh-CN'][key])
-  .join('\n')
-technicalTerms.forEach(term => {
-  assert.strictEqual(
-    simplifiedChineseNotes.includes(term),
-    false,
-    `user-facing changelog should not contain technical term: ${term}`
-  )
-})
-
-const projectRoot = path.join(__dirname, '..')
-const compatibilityIconPath = path.join(projectRoot, 'assets', 'icon', '71.png')
-const pngSignature = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])
-assert.ok(fs.existsSync(compatibilityIconPath), 'compatibility icon 71.png is missing')
-assert.ok(
-  fs.readFileSync(compatibilityIconPath).subarray(0, 8).equals(pngSignature),
-  'compatibility icon 71.png is not a valid PNG'
-)
-
-const dryRunOutput = execFileSync(
-  process.platform === 'win32' ? 'npm.cmd' : 'npm',
-  ['pack', '--dry-run', '--json', '--ignore-scripts'],
-  { cwd: projectRoot, encoding: 'utf8' }
-)
-const dryRun = JSON.parse(dryRunOutput)
-const packedFiles = new Set(dryRun[0].files.map(file => file.path))
-assert.ok(
-  packedFiles.has('assets/icon/71.png'),
-  'npm package is missing assets/icon/71.png'
-)
-
-
-const ships = {
-  89: { api_id: 89, api_name: '鳳翔' },
-  622: { api_id: 622, api_name: '夕張改二' },
-  623: { api_id: 623, api_name: '夕張改二特' },
-  624: { api_id: 624, api_name: '夕張改二丁' },
-  718: { api_id: 718, api_name: '玉波改' },
-  1033: { api_id: 1033, api_name: '玉波改二' },
-}
-
-const resolveShipName = createShipNameResolver(ships, name => `local:${name}`)
-
-const exact = normalizeAssistant({
-  id: [89],
-  text: '鳳翔',
-  week: [true, false, false, false, false, false, false],
-}, resolveShipName)
-assert.deepStrictEqual(exact.shipIds, [89])
-assert.strictEqual(exact.idsComplete, true)
-assert.strictEqual(exact.displayText, 'local:鳳翔')
-
-const legacyIrregular = normalizeAssistant({
-  id: [622],
-  text: '夕張改二/特/丁',
-  week: [true, true, true, true, true, true, true],
-}, resolveShipName)
-assert.strictEqual(legacyIrregular.idsComplete, false)
-assert.strictEqual(legacyIrregular.displayText, '夕張改二/特/丁')
-
-const generatedButNotConnected = normalizeAssistant({
-  id: [622],
-  shipIdList: [622, 623, 624],
-  text: '夕張改二/特/丁',
-  parseStatus: 'resolved',
-  week: [true, true, true, true, true, true, true],
-}, resolveShipName)
-assert.strictEqual(generatedButNotConnected.idsComplete, false)
-assert.strictEqual(generatedButNotConnected.displayText, '夕張改二/特/丁')
-
-const resolvedMultiple = normalizeAssistant({
-  id: [622, 623, 624],
-  text: '夕張改二/特/丁',
-  week: [true, true, true, true, true, true, true],
-}, resolveShipName)
-assert.strictEqual(resolvedMultiple.idsComplete, true)
-assert.strictEqual(
-  resolvedMultiple.displayText,
-  'local:夕張改二 / local:夕張改二特 / local:夕張改二丁'
-)
-
-const explicitSingle = normalizeAssistant({
-  id: [622],
-  text: '夕張改二のみ',
-  idsComplete: true,
-  week: [true, true, true, true, true, true, true],
-}, resolveShipName)
-assert.strictEqual(explicitSingle.displayText, 'local:夕張改二')
-
-const unknown = normalizeAssistant({
-  shipIds: [9999],
-  resolved: true,
-  week: [true],
-}, resolveShipName)
-assert.strictEqual(unknown.displayText, '#9999')
-
-assert.deepStrictEqual(normalizeShipIds({ id: ['89', 89, 0, 'bad'] }), [89])
-
-
-const noSpecificAssistant = normalizeAssistant({
-  id: [0],
-  text: '',
-  week: [true, true, false, false, false, false, false],
-}, resolveShipName)
-assert.deepStrictEqual(noSpecificAssistant.shipIds, [])
-assert.strictEqual(noSpecificAssistant.displayText, '')
-assert.deepStrictEqual(noSpecificAssistant.days, [0, 1])
-
-const improvementList = [
-  {
-    assistantList: [exact, legacyIrregular],
-  },
-]
-const textByDay = buildAssistantTextByDay(improvementList)
-assert.strictEqual(textByDay[0], 'local:鳳翔 / 夕張改二/特/丁')
-assert.strictEqual(textByDay[1], '夕張改二/特/丁')
-assert.strictEqual(textByDay[-1], 'local:鳳翔 / 夕張改二/特/丁')
-
-const item = buildImprovementItem({
-  id: 19,
-  improvementList: [
-    {
-      shipWeekList: [
-        {
-          id: [89],
-          text: '鳳翔',
-          week: [true, false, false, false, false, false, false],
-        },
-      ],
-    },
-  ],
-}, { api_name: '九六式艦戦' }, resolveShipName)
-assert.strictEqual(item.api_name, '九六式艦戦')
-assert.strictEqual(item.improvementList[0].assistantList[0].displayText, 'local:鳳翔')
-assert.strictEqual(item.assistantTextByDay[0], 'local:鳳翔')
-assert.strictEqual(item.assistantTextByDay[1], '')
-
-
-const listProjection = normalizeListProjection({
-  metadata: { schemaVersion: 2 },
-  data: [
-    [[19, ['鳳翔', '鳳翔改二']]],
-    [[19, ['鳳翔']]],
-    [], [], [], [], [], [],
-  ],
-})
-assert.deepStrictEqual(listProjection.itemIdsByDay[-1], [19])
-assert.deepStrictEqual(listProjection.itemIdsByDay[0], [19])
-assert.strictEqual(listProjection.assistantTextByItemId[19][-1], '鳳翔 / 鳳翔改二')
-assert.strictEqual(listProjection.assistantTextByItemId[19][0], '鳳翔')
-
-const kancolleData = require('@sakura2333/kancolle-data')
-
-const {
-  DATA_PACKAGE_NAME,
-  MAX_SUPPORTED_IMPROVEMENT_SCHEMA_VERSION,
-  getDataPackageManifest,
-  getImprovementDataPaths,
-  getUseitemIconPath,
-} = require('../views/data-package.js')
-
-const packageManifest = getDataPackageManifest()
-assert.strictEqual(DATA_PACKAGE_NAME, '@sakura2333/kancolle-data')
-assert.strictEqual(packageManifest.datasets.improvement.schemaVersion, 3)
-assert.strictEqual(MAX_SUPPORTED_IMPROVEMENT_SCHEMA_VERSION, 3)
-assert.ok(fs.existsSync(getImprovementDataPaths().listPath))
-assert.ok(fs.existsSync(getImprovementDataPaths().detailPath))
-assert.ok(fs.existsSync(getUseitemIconPath(57)))
-const listAsset = JSON.parse(fs.readFileSync(kancolleData.improvement.listPath, 'utf8'))
-const detailIds = new Set(
-  fs.readFileSync(kancolleData.improvement.detailPath, 'utf8')
-    .split('\n')
-    .filter(Boolean)
-    .map(line => JSON.parse(line).id)
-)
-assert.strictEqual(listAsset.metadata.schemaVersion, 2)
-assert.ok(fs.existsSync(kancolleData.manifestPath))
-assert.ok(fs.existsSync(kancolleData.assets.useitemPath(57)))
-assert.strictEqual(listAsset.data.length, 8)
-listAsset.data.forEach(rows => rows.forEach(([itemId]) => assert.ok(detailIds.has(itemId))))
-
-
-const detailRows = fs.readFileSync(kancolleData.improvement.detailPath, 'utf8')
-  .split('\n')
-  .filter(Boolean)
-  .map(line => JSON.parse(line))
-const tamanamiRouteItem = detailRows.find(row => row.id === 267)
-assert.ok(tamanamiRouteItem)
-assert.strictEqual(tamanamiRouteItem.improvementList.length, 2)
-const normalRoute = tamanamiRouteItem.improvementList.find(route => route.routeType === 'default')
-const specialRoute = tamanamiRouteItem.improvementList.find(route => route.routeType === 'assistant-specific')
-assert.ok(normalRoute)
-assert.ok(specialRoute)
-assert.deepStrictEqual(specialRoute.routeShipIds, [1033])
-assert.deepStrictEqual(specialRoute.stageList[0].consumables, [{ id: 10, count: 3, type: 0 }])
-assert.deepStrictEqual(normalRoute.stageList[0].consumables, [{ id: 3, count: 2, type: 0 }])
-const normalizedTamanami = buildImprovementItem(tamanamiRouteItem, { api_name: tamanamiRouteItem.name }, resolveShipName)
-assert.strictEqual(normalizedTamanami.improvementList.length, 2)
-assert.strictEqual(
-  normalizedTamanami.improvementList.find(route => route.routeType === 'assistant-specific').assistantList[0].displayText,
-  'local:玉波改二'
-)
-
-console.log('improvement-data tests passed')