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

package/CHANGELOG.md

@@ -9,6 +9,35 @@ All notable changes to `poi-plugin-item-improvement2-beta` are documented here.
 - 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

package/i18n/en-US.json

@@ -48,13 +48,15 @@
   "What's New": "What's New",
   "Release Notes": "Release Notes",
   "Close": "Close",
-  "changelog_1_0_22_release_dialog": "Added a release notes dialog that appears once after a plugin update.",
-  "changelog_1_0_22_manual_entry": "Added a What's New button so release notes can be opened again at any time.",
-  "changelog_1_0_21_split_data": "Separated improvement list data from detailed route data and enabled independent data updates.",
-  "changelog_1_0_21_route_tables": "Improvement routes with different materials, costs, or upgrade targets are now shown in separate tables.",
-  "changelog_1_0_21_tamanami": "Added support for Tamanami Kai Ni's assistant-specific improvement material route.",
-  "changelog_1_0_23_data_package": "Improvement data now comes from the versioned @sakura2333/kancolle-data package.",
-  "changelog_1_0_23_no_runtime_sync": "Removed runtime GitHub synchronization; data is installed together with the plugin through npm.",
-  "changelog_1_0_23_shared_icons": "Use-item PNG assets are now shared through the data package by both official and beta plugins.",
-  "changelog_1_0_24_data_patch_range": "Compatible 0.1.x data-package patches can now be resolved during plugin installation or dependency refresh."
+  "changelog_1_0_26_useitem_icon": "Fixed a missing material icon after installation so the affected item now displays correctly.",
+  "changelog_1_0_25_user_focused": "Release notes now focus on visible features and usability, while implementation details stay out of the in-app dialog.",
+  "changelog_1_0_24_compatible_data_updates": "Compatible improvement-data updates can now be picked up when the plugin is installed or updated, reducing the need for frequent plugin releases.",
+  "changelog_1_0_23_offline_ready": "Improvement data and material icons are now installed with the plugin, so startup no longer waits for an online sync.",
+  "changelog_1_0_23_network_resilience": "The improvement view remains available when the network is unstable or temporarily offline.",
+  "changelog_1_0_23_consistent_data": "Stable and test releases now use the same improvement data for more consistent results.",
+  "changelog_1_0_22_auto_notes": "The plugin now shows the latest changes once after an update.",
+  "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."
 }

package/i18n/ja-JP.json

@@ -48,13 +48,15 @@
   "What's New": "更新履歴",
   "Release Notes": "更新履歴",
   "Close": "閉じる",
-  "changelog_1_0_22_release_dialog": "プラグイン更新後に一度だけ表示される更新履歴ダイアログを追加しました。",
-  "changelog_1_0_22_manual_entry": "更新履歴をいつでも再表示できるボタンを追加しました。",
-  "changelog_1_0_21_split_data": "改修一覧データと詳細ルートデータを分離し、データを独立して更新できるようにしました。",
-  "changelog_1_0_21_route_tables": "必要装備、資材、更新先が異なる改修ルートを別々の表で表示するようにしました。",
-  "changelog_1_0_21_tamanami": "玉波改二限定の改修素材ルートに対応しました。",
-  "changelog_1_0_23_data_package": "改修データをバージョン管理された @sakura2333/kancolle-data パッケージから読み込むようにしました。",
-  "changelog_1_0_23_no_runtime_sync": "起動時の GitHub 同期を廃止し、npm 依存関係としてデータをインストールするようにしました。",
-  "changelog_1_0_23_shared_icons": "アイテム PNG をデータパッケージに移し、正式版とベータ版で共用するようにしました。",
-  "changelog_1_0_24_data_patch_range": "プラグインのインストールまたは依存関係の更新時に、互換性のある 0.1.x データパッケージ更新を取得できるようにしました。"
+  "changelog_1_0_26_useitem_icon": "インストール後に一部の資材アイコンが欠ける問題を修正し、正しく表示されるようになりました。",
+  "changelog_1_0_25_user_focused": "更新履歴を機能変更と使い勝手の内容に整理し、開発やデータ構造の詳細は表示しないようにしました。",
+  "changelog_1_0_24_compatible_data_updates": "プラグインのインストールや更新時に互換性のある新しい改修データを取得できるようになり、データ更新のたびにプラグインを更新する必要が減りました。",
+  "changelog_1_0_23_offline_ready": "改修データと資材アイコンをプラグインと一緒にインストールするようにし、起動時のオンライン同期待ちをなくしました。",
+  "changelog_1_0_23_network_resilience": "通信が不安定な場合や一時的にオフラインの場合でも、改修画面を利用できます。",
+  "changelog_1_0_23_consistent_data": "正式版とテスト版で同じ改修データを使用し、表示内容を統一しました。",
+  "changelog_1_0_22_auto_notes": "プラグイン更新後に、そのバージョンの変更内容を一度だけ自動表示するようにしました。",
+  "changelog_1_0_22_reopen_notes": "ツールバーに「更新履歴」ボタンを追加し、いつでも変更内容を確認できるようにしました。",
+  "changelog_1_0_21_stable_data": "改修情報の読み込みと更新をより安定させました。",
+  "changelog_1_0_21_separate_routes": "必要装備、資材、更新先が異なる改修ルートを別々の表で表示するようにしました。",
+  "changelog_1_0_21_tamanami_route": "玉波改二専用の改修素材ルートを追加し、通常ルートと混在しないようにしました。"
 }

package/i18n/zh-CN.json

@@ -48,13 +48,15 @@
   "What's New": "更新日志",
   "Release Notes": "更新日志",
   "Close": "关闭",
-  "changelog_1_0_22_release_dialog": "新增插件升级后仅显示一次的更新日志弹窗。",
-  "changelog_1_0_22_manual_entry": "新增“更新日志”按钮，可随时再次查看版本变化。",
-  "changelog_1_0_21_split_data": "分离改修列表数据与详细路线数据，并支持数据独立更新。",
-  "changelog_1_0_21_route_tables": "材料、资材或升级目标不同的改修路线现在会分表展示。",
-  "changelog_1_0_21_tamanami": "新增玉波改二限定改修材料路线支持。",
-  "changelog_1_0_23_data_package": "改修数据改为从版本化的 @sakura2333/kancolle-data 数据包读取。",
-  "changelog_1_0_23_no_runtime_sync": "移除运行时 GitHub 同步，数据会通过 npm 依赖随插件安装。",
-  "changelog_1_0_23_shared_icons": "资材 PNG 已迁移到数据包，并由正式版与 Beta 版共同使用。",
-  "changelog_1_0_24_data_patch_range": "插件安装或刷新依赖时，现在可以自动解析兼容的 0.1.x 数据包补丁版本。"
+  "changelog_1_0_26_useitem_icon": "修复部分资材图标在安装后的插件中缺失，相关资材现在可以正常显示。",
+  "changelog_1_0_25_user_focused": "更新日志现在只展示功能变化和使用体验，开发与数据结构细节不再打扰日常使用。",
+  "changelog_1_0_24_compatible_data_updates": "改修资料会在安装或更新插件时获取兼容的新版本，后续资料更新不必频繁升级插件。",
+  "changelog_1_0_23_offline_ready": "改修资料和资材图标现在会随插件一起安装，启动时无需再等待在线同步。",
+  "changelog_1_0_23_network_resilience": "网络不稳定或暂时离线时，改修页面仍可正常使用。",
+  "changelog_1_0_23_consistent_data": "正式版与测试版共用同一套改修资料，显示结果更加一致。",
+  "changelog_1_0_22_auto_notes": "插件更新后会自动展示一次本次版本变化。",
+  "changelog_1_0_22_reopen_notes": "工具栏新增“更新日志”按钮，可随时回看版本变化。",
+  "changelog_1_0_21_stable_data": "改修信息的加载和更新更加稳定。",
+  "changelog_1_0_21_separate_routes": "材料、资材或升级目标不同的改修路线现在会分表展示。",
+  "changelog_1_0_21_tamanami_route": "补充玉波改二专属的改修材料路线，避免与普通路线混在一起。"
 }

package/i18n/zh-TW.json

@@ -48,13 +48,15 @@
   "What's New": "更新日誌",
   "Release Notes": "更新日誌",
   "Close": "關閉",
-  "changelog_1_0_22_release_dialog": "新增外掛升級後僅顯示一次的更新日誌視窗。",
-  "changelog_1_0_22_manual_entry": "新增「更新日誌」按鈕，可隨時再次查看版本變更。",
-  "changelog_1_0_21_split_data": "分離改修列表資料與詳細路線資料，並支援資料獨立更新。",
-  "changelog_1_0_21_route_tables": "材料、資材或升級目標不同的改修路線現在會分表顯示。",
-  "changelog_1_0_21_tamanami": "新增玉波改二限定改修材料路線支援。",
-  "changelog_1_0_23_data_package": "改修資料改為從版本化的 @sakura2333/kancolle-data 資料包讀取。",
-  "changelog_1_0_23_no_runtime_sync": "移除執行時 GitHub 同步，資料會透過 npm 相依套件隨外掛安裝。",
-  "changelog_1_0_23_shared_icons": "資材 PNG 已遷移到資料包，並由正式版與 Beta 版共同使用。",
-  "changelog_1_0_24_data_patch_range": "外掛安裝或重新整理相依套件時，現在可以自動解析相容的 0.1.x 資料包修補版本。"
+  "changelog_1_0_26_useitem_icon": "修正部分資材圖示在安裝後的插件中缺失，相關資材現在可以正常顯示。",
+  "changelog_1_0_25_user_focused": "更新日誌現在只顯示功能變化與使用體驗，開發及資料結構細節不再干擾日常使用。",
+  "changelog_1_0_24_compatible_data_updates": "改修資料會在安裝或更新外掛時取得相容的新版本，後續資料更新不必頻繁升級外掛。",
+  "changelog_1_0_23_offline_ready": "改修資料與資材圖示現在會隨外掛一同安裝，啟動時不必再等待線上同步。",
+  "changelog_1_0_23_network_resilience": "網路不穩定或暫時離線時，改修頁面仍可正常使用。",
+  "changelog_1_0_23_consistent_data": "正式版與測試版共用同一套改修資料，顯示結果更加一致。",
+  "changelog_1_0_22_auto_notes": "外掛更新後會自動顯示一次本次版本變更。",
+  "changelog_1_0_22_reopen_notes": "工具列新增「更新日誌」按鈕，可隨時回看版本變更。",
+  "changelog_1_0_21_stable_data": "改修資訊的載入與更新更加穩定。",
+  "changelog_1_0_21_separate_routes": "材料、資材或升級目標不同的改修路線現在會分表顯示。",
+  "changelog_1_0_21_tamanami_route": "補充玉波改二專屬的改修材料路線，避免與一般路線混在一起。"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-item-improvement2-beta",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "description": "use new data source",
   "main": "index.js",
   "scripts": {
@@ -57,5 +57,16 @@
       "8.0.99": "5.0.6",
       "8.3.0": "6.0.1"
     }
-  }
+  },
+  "files": [
+    "index.js",
+    "views/**/*.js",
+    "assets/**/*",
+    "i18n/*.json",
+    "scripts/publish-beta.js",
+    "tests/improvement-data.test.js",
+    "CHANGELOG.md",
+    "README.md",
+    "REFACTOR_NOTES.md"
+  ]
 }

package/tests/improvement-data.test.js

@@ -1,4 +1,7 @@
 const assert = require('assert')
+const fs = require('fs')
+const path = require('path')
+const { execFileSync } = require('child_process')
 const {
   buildAssistantTextByDay,
   buildImprovementItem,
@@ -10,6 +13,7 @@ const {
 
 
 const {
+  CHANGELOG,
   compareVersions,
   getChangelogEntriesSince,
 } = require('../views/changelog.js')
@@ -19,13 +23,80 @@ 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.24', '1.0.23', '1.0.22']
+  ['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.24', '1.0.23', '1.0.22', '1.0.21']
+  ['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: '夕張改二' },
@@ -145,7 +216,6 @@ assert.deepStrictEqual(listProjection.itemIdsByDay[0], [19])
 assert.strictEqual(listProjection.assistantTextByItemId[19][-1], '鳳翔 / 鳳翔改二')
 assert.strictEqual(listProjection.assistantTextByItemId[19][0], '鳳翔')
 
-const fs = require('fs')
 const kancolleData = require('@sakura2333/kancolle-data')
 
 const {

package/views/changelog.js

@@ -9,20 +9,27 @@ const CURRENT_VERSION = pluginPackage.version;
 exports.CURRENT_VERSION = CURRENT_VERSION;
 const CHANGELOG_CONFIG_KEY = 'poi-plugin-item-improvement2-beta.lastSeenChangelogVersion';
 exports.CHANGELOG_CONFIG_KEY = CHANGELOG_CONFIG_KEY;
-const CHANGELOG_BASELINE_VERSION = '1.0.20';
+const CHANGELOG_BASELINE_VERSION = '1.0.20'; // Keep in-app notes focused on user-visible behavior. Engineering details belong in CHANGELOG.md.
+
 exports.CHANGELOG_BASELINE_VERSION = CHANGELOG_BASELINE_VERSION;
 const CHANGELOG = [{
+  version: '1.0.26',
+  items: ['changelog_1_0_26_useitem_icon']
+}, {
+  version: '1.0.25',
+  items: ['changelog_1_0_25_user_focused']
+}, {
   version: '1.0.24',
-  items: ['changelog_1_0_24_data_patch_range']
+  items: ['changelog_1_0_24_compatible_data_updates']
 }, {
   version: '1.0.23',
-  items: ['changelog_1_0_23_data_package', 'changelog_1_0_23_no_runtime_sync', 'changelog_1_0_23_shared_icons']
+  items: ['changelog_1_0_23_offline_ready', 'changelog_1_0_23_network_resilience', 'changelog_1_0_23_consistent_data']
 }, {
   version: '1.0.22',
-  items: ['changelog_1_0_22_release_dialog', 'changelog_1_0_22_manual_entry']
+  items: ['changelog_1_0_22_auto_notes', 'changelog_1_0_22_reopen_notes']
 }, {
   version: '1.0.21',
-  items: ['changelog_1_0_21_split_data', 'changelog_1_0_21_route_tables', 'changelog_1_0_21_tamanami']
+  items: ['changelog_1_0_21_stable_data', 'changelog_1_0_21_separate_routes', 'changelog_1_0_21_tamanami_route']
 }];
 exports.CHANGELOG = CHANGELOG;