Merge branch 'refactor/assets-bootstrap'

assets/*.js の保守性・可読性向上リファクタを取り込み:
- Jig.bootstrap.register によるページ初期化の共通化
- outbound.js の Mermaid 生成 3 関数の共通部分抽出
- domain.js のセクション区切り整理と関数の並び替え
- Jig.mermaid.createBuilder() ファクトリ追加
- library-dependency データの Jig.data 経由化
- jig-data.js のパッケージキャッシュ lazy 化
- 軽微なクリーンアップ（index.js innerHTML、fqnToId コメント）

Author: irof

jig-core/build.gradle

@@ -91,7 +91,8 @@ def bundleJsTask = tasks.register("bundleJs") {
             'src/main/resources/templates/assets/jig-data.js',
             'src/main/resources/templates/assets/jig-glossary.js',
             'src/main/resources/templates/assets/jig-dom.js',
-            'src/main/resources/templates/assets/jig-mermaid.js'
+            'src/main/resources/templates/assets/jig-mermaid.js',
+            'src/main/resources/templates/assets/jig-bootstrap.js'
     )
     def outputFile = bundleJsOutputDir.map { it.file("templates/assets/jig-bundle.js") }
 

jig-core/src/main/resources/templates/assets/domain.js

@@ -251,10 +251,6 @@ const GlossaryApp = (() => {
     }
 
     function init() {
-        if (typeof document === "undefined" || !document.body.classList.contains("glossary")) {
-            return;
-        }
-
         const terms = getGlossaryData();
 
         const controls = {
@@ -344,11 +340,7 @@ const GlossaryApp = (() => {
     };
 })();
 
-if (typeof document !== "undefined") {
-    document.addEventListener("DOMContentLoaded", () => {
-        GlossaryApp.init();
-    });
-}
+Jig.bootstrap.register("glossary", GlossaryApp.init);
 
 if (typeof module !== "undefined" && module.exports) {
     module.exports = GlossaryApp;

jig-core/src/main/resources/templates/assets/glossary.js

@@ -84,7 +84,6 @@ const InboundApp = (() => {
 
     function buildDiagramBuilder(data, builder, showPhysicalName = false) {
         const fqnToNodeId = (fqn) => Jig.util.fqnToId("n", fqn);
-        builder.applyThemeClassDefs();
         const {type: typeLabel, method: mLabel} = Jig.glossary.makeLabels(showPhysicalName);
 
         data.entrypointGroups.forEach((eps, typeFqn) => {
@@ -448,7 +447,7 @@ const InboundApp = (() => {
             Jig.mermaid.diagram.createAndRegister(jigCard, (mmdContainer) => {
                 const diagramGenerator = (dir, opts) => {
                     const data = prepareDiagramData(adapter, usecaseData);
-                    const builder = new Jig.mermaid.Builder();
+                    const builder = Jig.mermaid.createBuilder();
                     buildDiagramBuilder(data, builder, opts?.showPhysicalName);
                     return builder.build(dir);
                 };
@@ -469,11 +468,7 @@ const InboundApp = (() => {
     };
 })();
 
-if (typeof document !== 'undefined') {
-    document.addEventListener("DOMContentLoaded", () => {
-        InboundApp.init();
-    });
-}
+Jig.bootstrap.register("inbound-interface", InboundApp.init);
 
 if (typeof module !== "undefined" && module.exports) {
     module.exports = InboundApp;

jig-core/src/main/resources/templates/assets/inbound.js

@@ -12,7 +12,6 @@ const IndexApp = (() => {
         const domainPackageDiagram = Jig.dom.createElement("div", {className: "mermaid-diagram"});
         packageDiagramContainer.appendChild(domainPackageDiagram);
 
-        domainPackageDiagram.innerHTML = "";
         const generator = (dir, opts) => Jig.mermaid.createPackageLevelDiagram(
             {fqn: packageRoot},
             allPackages, allPackageRelations,
@@ -97,10 +96,6 @@ const IndexApp = (() => {
     }
 
     function init() {
-        if (typeof document === "undefined" || !document.body.classList.contains("index")) {
-            return;
-        }
-
         renderSummary();
         renderDocumentLinks();
 
@@ -170,8 +165,4 @@ const IndexApp = (() => {
     };
 })();
 
-if (typeof document !== 'undefined') {
-    document.addEventListener("DOMContentLoaded", () => {
-        IndexApp.init();
-    });
-}
+Jig.bootstrap.register("index", IndexApp.init);

jig-core/src/main/resources/templates/assets/index.js

@@ -151,10 +151,6 @@ const InsightApp = (() => {
     }
 
     function init() {
-        if (typeof document === "undefined" || !document.body.classList.contains("insight")) {
-            return;
-        }
-
         const insightData = parseInsightData();
         if (insightData) {
             renderPackageInsights(insightData.packages || []);
@@ -184,11 +180,7 @@ const InsightApp = (() => {
     }
 })();
 
-if (typeof document !== "undefined") {
-    document.addEventListener("DOMContentLoaded", () => {
-        InsightApp.init();
-    });
-}
+Jig.bootstrap.register("insight", InsightApp.init);
 
 if (typeof module !== "undefined" && module.exports) {
     module.exports = InsightApp;

jig-core/src/main/resources/templates/assets/insight.js

@@ -0,0 +1,17 @@
+globalThis.Jig ??= {};
+
+globalThis.Jig.bootstrap = (() => {
+
+    function register(bodyClass, initFn) {
+        if (typeof document === "undefined") return;
+        document.addEventListener("DOMContentLoaded", () => {
+            if (document.body.classList.contains(bodyClass)) initFn();
+        });
+    }
+
+    return {register};
+})();
+
+if (typeof module !== "undefined" && module.exports) {
+    module.exports = globalThis.Jig.bootstrap;
+}

jig-core/src/main/resources/templates/assets/jig-bootstrap.js

@@ -20,6 +20,48 @@ globalThis.Jig.data = (() => {
     /** @type {Map<string, object>|null} */
     let usecaseTypesMap = null;
 
+    function buildDomainPackages(domainPackageRoots, types) {
+        const packageTypesMap = new Map();
+
+        for (const type of types) {
+            const lastDot = type.fqn.lastIndexOf('.');
+            if (lastDot < 0) continue;
+            const pkgFqn = type.fqn.substring(0, lastDot);
+
+            globalThis.Jig.util.pushToMap(packageTypesMap, pkgFqn, {fqn: type.fqn});
+
+            // 子パッケージのみを持つ中間パッケージのナビゲーションを成立させるため、
+            // pkgFqn から domainPackageRoots に到達するまで空の親パッケージも Map に登録する
+            let current = pkgFqn;
+            while (!domainPackageRoots.includes(current)) {
+                const parentDot = current.lastIndexOf('.');
+                if (parentDot < 0) break;
+                const parent = current.substring(0, parentDot);
+                const isUnderRoot = domainPackageRoots.some(
+                    root => parent === root || parent.startsWith(root + '.'));
+                if (!isUnderRoot) break;
+                if (!packageTypesMap.has(parent)) packageTypesMap.set(parent, []);
+                current = parent;
+            }
+        }
+
+        return Array.from(packageTypesMap.entries())
+            .map(([fqn, pkgTypes]) => ({
+                fqn,
+                types: pkgTypes.sort((a, b) => a.fqn.localeCompare(b.fqn))
+            }))
+            .sort((a, b) => a.fqn.localeCompare(b.fqn));
+    }
+
+    function buildChildPackagesMap(packages) {
+        const map = new Map(packages.map(p => [p.fqn, []]));
+        packages.forEach(p => {
+            const parentFqn = p.fqn.substring(0, p.fqn.lastIndexOf('.'));
+            if (map.has(parentFqn)) map.get(parentFqn).push(p);
+        });
+        return map;
+    }
+
     const domain = {
         get() {
             return globalThis.domainData;
@@ -46,17 +88,18 @@ globalThis.Jig.data = (() => {
             return domainFqnSet;
         },
         getPackages() {
+            if (!domainPackages) {
+                const data = globalThis.domainData;
+                domainPackages = data ? buildDomainPackages(data.domainPackageRoots, data.types) : [];
+            }
             return domainPackages;
         },
-        setPackages(packages) {
-            domainPackages = packages;
-        },
         getChildPackagesMap() {
+            if (!domainChildPackagesMap) {
+                domainChildPackagesMap = buildChildPackagesMap(domain.getPackages());
+            }
             return domainChildPackagesMap;
         },
-        setChildPackagesMap(map) {
-            domainChildPackagesMap = map;
-        },
     };
 
     const glossary = {
@@ -124,6 +167,12 @@ globalThis.Jig.data = (() => {
         },
     };
 
+    const library = {
+        get() {
+            return globalThis.libraryDependencyData;
+        },
+    };
+
     const navigation = {
         get() {
             return globalThis.navigationData;
@@ -213,6 +262,7 @@ globalThis.Jig.data = (() => {
         package: pkg,
         insight,
         list,
+        library,
         navigation,
         summary,
         typeRelations,

jig-core/src/main/resources/templates/assets/jig-data.js

@@ -594,8 +594,15 @@ globalThis.Jig.mermaid = (() => {
             return parentFqns;
         }
 
+        function createBuilder() {
+            const builder = new MermaidBuilder();
+            builder.applyThemeClassDefs();
+            return builder;
+        }
+
         return {
             MermaidBuilder,
+            createBuilder,
             nodeStyleDefs,
             nodeShapes,
             escapeId,
@@ -1621,6 +1628,7 @@ globalThis.Jig.mermaid = (() => {
         // 高レベルAPI
         createPackageLevelDiagram,
         Builder: builder.MermaidBuilder,
+        createBuilder: builder.createBuilder,
         ClassDiagramBuilder,
         nav,
     };

jig-core/src/main/resources/templates/assets/jig-mermaid.js

@@ -104,7 +104,9 @@ globalThis.Jig.util = (() => {
      * @return {string}
      */
     function fqnToId(prefix, fqn) {
-        // マルチバイト文字をハッシュ化して一意なIDを生成
+        // DJB2 系の 32bit ハッシュ。衝突した場合は同一画面内で別の FQN が同じ ID を持ち、
+        // ページ内アンカー (`#id`) や Mermaid のクリック先が混線する。FQN は通常重複しないため
+        // 実害は出ていないが、衝突が観測されたらハッシュ幅拡張または完全な FQN を ID 化に切替える。
         let hash = 0;
         for (let i = 0; i < fqn.length; i++) {
             const char = fqn.charCodeAt(i);