Initial commit: CraftDock as of 2026-11-01

The previous GitHub history was lost with the account (the local .git was missing
its refs and most objects), so this repository starts from the existing code.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scripts/extract-mc-assets.mjs

@@ -0,0 +1,59 @@
+// Extracts flat item icons from the minecraft-assets devDependency into
+// src/public/assets/mc/items/<item>.png so the panel serves them locally
+// (offline-friendly, no runtime dependency, tiny footprint vs the full pkg).
+//
+// Usage: node scripts/extract-mc-assets.mjs [version] [--required]
+//   version     defaults to the newest available in the package
+//   --required  fail (exit 1) when minecraft-assets is not installed — used by
+//               the Dockerfile assets stage. Without it the script is a no-op
+//               warning, so `npm ci --omit=dev` (postinstall) doesn't break.
+//
+// The output dir is gitignored: icons are generated at Docker build time (see
+// Dockerfile "assets" stage) and by postinstall for local dev.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const dataRoot = path.join(here, '..', 'node_modules', 'minecraft-assets', 'minecraft-assets', 'data');
+const outDir = path.join(here, '..', 'src', 'public', 'assets', 'mc', 'items');
+
+const required = process.argv.includes('--required');
+const args = process.argv.slice(2).filter((a) => a !== '--required');
+
+if (!fs.existsSync(dataRoot)) {
+  if (required) {
+    console.error('minecraft-assets is not installed — run `npm install` (with dev deps) first');
+    process.exit(1);
+  }
+  console.warn('minecraft-assets not installed (prod install?) — skipping icon extraction');
+  process.exit(0);
+}
+
+const versions = fs.readdirSync(dataRoot)
+  .filter((v) => /^\d+\.\d+(\.\d+)?$/.test(v))
+  .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
+const version = args[0] || versions.at(-1);
+const src = path.join(dataRoot, version);
+if (!fs.existsSync(src)) {
+  console.error(`version ${version} not found; available: ${versions.join(', ')}`);
+  process.exit(1);
+}
+
+const entries = JSON.parse(fs.readFileSync(path.join(src, 'items_textures.json'), 'utf8'));
+fs.rmSync(outDir, { recursive: true, force: true });
+fs.mkdirSync(outDir, { recursive: true });
+
+let copied = 0, skipped = 0;
+for (const { name, texture } of entries) {
+  if (!name || !texture || texture.includes('missingno')) { skipped++; continue; }
+  // texture is like "minecraft:item/iron_sword" or "minecraft:block/dirt"
+  const rel = texture.replace(/^minecraft:/, '').replace(/^item\//, 'items/').replace(/^block\//, 'blocks/');
+  const file = path.join(src, `${rel}.png`);
+  if (!fs.existsSync(file)) { skipped++; continue; }
+  fs.copyFileSync(file, path.join(outDir, `${name}.png`));
+  copied++;
+}
+
+console.log(`minecraft ${version}: ${copied} item icons → ${path.relative(process.cwd(), outDir)} (${skipped} without usable texture)`);