Gruntfile.js

const sass = require('sass');

// Sentinel kompletnego builda assetow. MUSI byc zgodny z `CSS_STAMP`
// w Makefile — to po jego mtime `make assets` decyduje, czy przebudowywac.
const SENTINEL_BUILDA = '.grunt-build-stamp';

module.exports = function (grunt) {
    grunt.initConfig({
        // pkg: grunt.file.readJSON('package.json'),

        sass: {
            options: {
                implementation: sass,
                api: 'modern-compiler',
                style: 'compressed',
                // Wyciszone deprecation warnings z Dart Sass:
                //   'global-builtin', 'if-function' — wewnętrzne wywołania
                //     w foundation-sites 6.9.0 (util/_value.scss, _breakpoint.scss,
                //     _color.scss, _flex.scss, _math.scss). Foundation przeszedł
                //     w tryb maintenance, fix nie nadejdzie z upstreamu.
                //   'import' — nasze entrypointy (app-{blue,green,orange}.scss,
                //     admin-themes.scss, common.scss) używają starego @import.
                //     Migracja do @use/@forward zaplanowana osobno (sass-migrator
                //     module --migrate-deps) — wymaga regresji wizualnej.
                silenceDeprecations: ['global-builtin', 'if-function', 'import'],
                loadPaths: [
                    'node_modules/foundation-sites/scss'
                ]
            },
            blue: {
                files: {
                    'src/bpp/static/scss/app-blue.css':
                        'src/bpp/static/scss/app-blue.scss'
                }
            },
            green: {
                files: {
                    'src/bpp/static/scss/app-green.css':
                        'src/bpp/static/scss/app-green.scss'
                }
            },
            orange: {
                files: {
                    'src/bpp/static/scss/app-orange.css':
                        'src/bpp/static/scss/app-orange.scss'
                }
            },
            vizja: {
                files: {
                    'src/bpp/static/scss/app-vizja.css':
                        'src/bpp/static/scss/app-vizja.scss'
                }
            },
            mwsl: {
                files: {
                    'src/bpp/static/scss/app-mwsl.css':
                        'src/bpp/static/scss/app-mwsl.scss'
                }
            },
            uafm: {
                files: {
                    'src/bpp/static/scss/app-uafm.css':
                        'src/bpp/static/scss/app-uafm.scss'
                }
            },
            adminthemes: {
                files: {
                    'src/bpp/static/bpp/css/admin-themes.css':
                        'src/bpp/static/bpp/scss/admin-themes.scss'
                }
            },
            adminfilterpanel: {
                files: {
                    'src/bpp/static/bpp/css/admin-filter-panel.css':
                        'src/bpp/static/bpp/scss/admin-filter-panel.scss'
                }
            },
            adminprint: {
                files: {
                    'src/bpp/static/bpp/css/admin-print.css':
                        'src/bpp/static/bpp/scss/admin-print.scss'
                }
            },
            przemapuj_zrodla: {
                files: {
                    'src/przemapuj_zrodla_pbn/static/przemapuj_zrodla_pbn/css/przemapuj-zrodla.css':
                        'src/przemapuj_zrodla_pbn/static/przemapuj_zrodla_pbn/scss/przemapuj-zrodla.scss'
                }
            },
            deduplikator_autorow: {
                files: {
                    'src/deduplikator_autorow/static/deduplikator_autorow/css/deduplikator_autorow.css':
                        'src/deduplikator_autorow/static/deduplikator_autorow/scss/deduplikator_autorow.scss'
                }
            },
            deduplikator_zrodel: {
                files: {
                    'src/deduplikator_zrodel/static/deduplikator_zrodel/css/deduplikator_zrodel.css':
                        'src/deduplikator_zrodel/static/deduplikator_zrodel/scss/deduplikator_zrodel.scss'
                }
            },
            ewaluacja_optymalizuj_publikacje: {
                files: {
                    'src/ewaluacja_optymalizuj_publikacje/static/ewaluacja_optymalizuj_publikacje/css/ewaluacja_optymalizuj_publikacje.css':
                        'src/ewaluacja_optymalizuj_publikacje/static/ewaluacja_optymalizuj_publikacje/scss/ewaluacja_optymalizuj_publikacje.scss'
                }
            },
            pbn_downloader_app: {
                files: {
                    'src/pbn_downloader_app/static/pbn_downloader_app/css/pbn_downloader_app.css':
                        'src/pbn_downloader_app/static/pbn_downloader_app/scss/pbn_downloader_app.scss'
                }
            },
            pbn_export_queue: {
                files: {
                    'src/pbn_export_queue/static/pbn_export_queue/css/pbn_export_queue.css':
                        'src/pbn_export_queue/static/pbn_export_queue/scss/pbn_export_queue.scss'
                }
            },
            przemapuj_prace_autora: {
                files: {
                    'src/przemapuj_prace_autora/static/przemapuj_prace_autora/css/admin.css':
                        'src/przemapuj_prace_autora/static/przemapuj_prace_autora/scss/admin.scss'
                }
            },
            ewaluacja_liczba_n: {
                files: {
                    'src/ewaluacja_liczba_n/static/ewaluacja_liczba_n/css/ewaluacja_liczba_n.css':
                        'src/ewaluacja_liczba_n/static/ewaluacja_liczba_n/scss/ewaluacja_liczba_n.scss'
                }
            },
            ewaluacja_dwudyscyplinowcy: {
                files: {
                    'src/ewaluacja_dwudyscyplinowcy/static/ewaluacja_dwudyscyplinowcy/css/ewaluacja_dwudyscyplinowcy.css':
                        'src/ewaluacja_dwudyscyplinowcy/static/ewaluacja_dwudyscyplinowcy/scss/ewaluacja_dwudyscyplinowcy.scss'
                }
            },
            pbn_import: {
                files: {
                    'src/pbn_import/static/pbn_import/css/pbn_import.css':
                        'src/pbn_import/static/pbn_import/scss/pbn_import.scss'
                }
            },
            pbn_import_admin: {
                files: {
                    'src/pbn_import/static/pbn_import/css/admin.css':
                        'src/pbn_import/static/pbn_import/scss/admin.scss'
                }
            },
            pbn_komparator_zrodel: {
                files: {
                    'src/pbn_komparator_zrodel/static/pbn_komparator_zrodel/css/pbn_komparator_zrodel.css':
                        'src/pbn_komparator_zrodel/static/pbn_komparator_zrodel/scss/pbn_komparator_zrodel.scss'
                }
            },
            bpp_setup_wizard: {
                files: {
                    'src/bpp_setup_wizard/static/bpp_setup_wizard/css/bpp_setup_wizard.css':
                        'src/bpp_setup_wizard/static/bpp_setup_wizard/scss/bpp_setup_wizard.scss'
                }
            },
            komparator_publikacji_pbn: {
                files: {
                    'src/komparator_publikacji_pbn/static/komparator_publikacji_pbn/css/komparator_publikacji_pbn.css':
                        'src/komparator_publikacji_pbn/static/komparator_publikacji_pbn/scss/komparator_publikacji_pbn.scss'
                }
            }
        },

        concurrent: {
            themes: {
                tasks: [
                    'sass:blue',
                    'sass:green',
                    'sass:orange',
                    'sass:vizja',
                    'sass:mwsl',
                    'sass:uafm',
                    'sass:adminthemes',
                    'sass:adminfilterpanel',
                    'sass:adminprint',
                    'sass:przemapuj_zrodla',
                    'sass:deduplikator_autorow',
                    'sass:deduplikator_zrodel',
                    'sass:ewaluacja_optymalizuj_publikacje',
                    'sass:pbn_downloader_app',
                    'sass:pbn_export_queue',
                    'sass:przemapuj_prace_autora',
                    'sass:ewaluacja_liczba_n',
                    'sass:ewaluacja_dwudyscyplinowcy',
                    'sass:pbn_import',
                    'sass:pbn_import_admin',
                    'sass:pbn_komparator_zrodel',
                    'sass:bpp_setup_wizard',
                    'sass:komparator_publikacji_pbn'
                ],
                options: {
                    logConcurrentOutput: true
                }
            }
        },

        "_watch": {
            grunt: {files: ['Gruntfile.js']},

            sass: {
                files: ['src/bpp/static/scss/*.scss','src/bpp/static/bpp/scss/*.scss'],
                tasks: ['concurrent:themes']
            }

        },

        shell: {
            // Create a stable .venv/lib/python symlink pointing to the
            // actual python3.XX directory, so bundle-entry.js imports
            // work regardless of Python version.
            // Respects UV_PROJECT_ENVIRONMENT (set to /opt/venv in the
            // test-runner Docker image) so the symlink resolves correctly
            // whether running locally (.venv) or in CI (/opt/venv).
            linkSitePackages: {
                command: 'VENV_DIR=${UV_PROJECT_ENVIRONMENT:-.venv} && ' +
                         'PY_DIR=$(ls -d "$VENV_DIR/lib/python3."* | head -1) && ' +
                         'mkdir -p .venv/lib && ' +
                         'rm -f .venv/lib/python && ' +
                         'ln -sf "$(cd "$PY_DIR" && pwd)" .venv/lib/python'
            },
            esbuild: {
                // --minify = --minify-syntax + --minify-whitespace +
                // --minify-identifiers. Ten ostatni byl wczesniej pominiety,
                // przez co bundle wozil pelne nazwy zmiennych (~136 KB raw /
                // ~21 KB gzip nadmiarowo). Mangling identyfikatorow jest
                // bezpieczny: kod wchodzacy do bundla siega do globali przez
                // window.* (patrz jquery-shim.js + sekcja GLOBAL EXPORTS
                // w bundle-entry.js), a esbuild nie zmienia nazw wlasciwosci.
                command: 'npx esbuild src/bpp/static/bpp/js/bundle-entry.js ' +
                         '--bundle --minify --sourcemap ' +
                         '--outfile=src/bpp/static/bpp/js/dist/bundle.js ' +
                         '--format=iife --target=es2018 ' +
                         '--inject:src/bpp/static/bpp/js/jquery-shim.js ' +
                         '--define:global=window'
            },
            // Osobny lazy bundle Cytoscape.js + fcose dla strony eksploratora
            // powiązań autorów (ładowany tylko na tej stronie, nie globalnie).
            esbuildCytoscape: {
                command: 'npx esbuild ' +
                         'src/powiazania_autorow/static/powiazania_autorow/js/cytoscape-entry.js ' +
                         '--bundle --minify-syntax --minify-whitespace --sourcemap ' +
                         '--outfile=src/powiazania_autorow/static/powiazania_autorow/js/dist/cytoscape-bundle.js ' +
                         '--format=iife --target=es2018'
            },
            // Osobny lazy bundle Three.js + 3d-force-graph dla widoku 3D sieci
            // powiązań (ładowany tylko na stronie 3D, nie globalnie).
            esbuildThree: {
                command: 'npx esbuild ' +
                         'src/powiazania_autorow/static/powiazania_autorow/js/three-entry.js ' +
                         '--bundle --minify-syntax --minify-whitespace --sourcemap ' +
                         '--outfile=src/powiazania_autorow/static/powiazania_autorow/js/dist/three-bundle.js ' +
                         '--format=iife --target=es2018'
            },
            // Post-process bundle to fix IIFE scope issues.
            //
            // django-autocomplete-light: `autocomplete_light.js` deklaruje
            // `var yl = yl || {}` (u siebie w module), ale `dal_select2/
            // select2.js` odwoluje sie do `yl` jako do GLOBALA (nigdzie go
            // nie deklaruje). Po zbundlowaniu kazdy plik ma wlasny scope,
            // wiec bez tej laty `yl.registerFunction("select2", ...)` leci
            // ReferenceError i WSZYSTKIE autocomplete'y DAL (admin + zgloszenia)
            // przestaja dzialac. Lata aliasuje modulowy `yl` na `window.yl`.
            //
            // Wzorzec jest odporny na `--minify-identifiers`: NIE zaklada
            // konkretnej nazwy (esbuild mangluje `yl` do czegos w rodzaju
            // `Bs`), tylko dopasowuje ksztalt deklaracji zakotwiczony na
            // dal-owym `.functions`. Na koncu twardy guard: jesli lata sie
            // nie zaaplikowala, build MUSI paść, zamiast po cichu wypuscic
            // zepsuty bundle (dokladnie tak zachowywala sie poprzednia,
            // sztywno wpisana wersja `var yl2=yl2||{}`).
            //
            // Celowo BRE (bez `-E`): BSD sed nie obsluguje wstecznych
            // referencji `\1` we wzorcu ERE, a potrzebujemy ich, zeby
            // zlapac te sama zmangowana nazwe trzy razy. BRE z `\(...\)`
            // + `\{1,\}` dziala tak samo na macOS (BSD) i w obrazie
            // testowym (GNU).
            patchBundle: {
                command:
                    "F=src/bpp/static/bpp/js/dist/bundle.js && " +
                    "sed -i.bak 's/var \\([A-Za-z0-9_$]\\{1,\\}\\)=\\1||{};" +
                    "\\1\\.functions=\\1\\.functions||{}/" +
                    "window.yl=window.yl||{};var \\1=window.yl;" +
                    "\\1.functions=\\1.functions||{}/g' \"$F\" && " +
                    "rm -f \"$F.bak\" && " +
                    "{ grep -q 'window.yl=window.yl||{}' \"$F\" || " +
                    "{ echo 'BLAD: lata yl NIE zaaplikowala sie - " +
                    "autocomplete DAL bylby zepsuty. Sprawdz wzorzec sed " +
                    "w Gruntfile (patchBundle).' >&2; exit 1; }; }"
            },
            copyRollbar: {
                command: 'mkdir -p src/bpp/static/rollbar && ' +
                         'cp node_modules/rollbar/dist/rollbar.umd.min.js ' +
                         'src/bpp/static/rollbar/rollbar.umd.min.js'
            },
            collectstatic: {
                command: 'uv run src/manage.py collectstatic --noinput -v0 --traceback'
            }
        }
    });

    grunt.loadNpmTasks('grunt-sass');
    grunt.loadNpmTasks('grunt-contrib-watch');
    grunt.loadNpmTasks('grunt-shell');
    grunt.loadNpmTasks('grunt-concurrent');

    grunt.registerTask('shell-test', ['shell:collectstatic']);

    // Odswieza sentinel, po ktorym `make assets` poznaje, ze assety sa
    // aktualne. Wczesniej `touch` robila wylacznie regula w Makefile, wiec
    // `npx grunt build` odpalony RECZNIE budowal pliki, ale zostawial
    // sentinel starszy niz zrodla — kolejny `make assets` przebudowywal
    // wszystko od nowa, mimo ze nie bylo po co. Latwo bylo tez wyciagnac
    // z tego bledny wniosek, ze build nie dziala.
    //
    // Zadanie stoi na KONCU listy `build`, bo grunt przerywa kolejke na
    // pierwszym bledzie: sentinel odswieza sie wylacznie wtedy, gdy
    // wszystkie wczesniejsze kroki faktycznie sie powiodly.
    grunt.registerTask(
        'stampBuild',
        'Odswieza sentinel kompletnego builda (patrz CSS_STAMP w Makefile)',
        function () {
            grunt.file.write(SENTINEL_BUILDA, '');
            grunt.log.ok('sentinel odswiezony: ' + SENTINEL_BUILDA);
        }
    );

    grunt.registerTask('build', [
        'concurrent:themes',
        'shell:linkSitePackages',
        'shell:esbuild',
        'shell:esbuildCytoscape',
        'shell:esbuildThree',
        'shell:patchBundle',
        'shell:copyRollbar',
        'shell:collectstatic',
        'stampBuild'
    ]);
    // `build-non-interactive` CELOWO nie dotyka sentinela: pomija
    // `collectstatic`, wiec nie spelnia tego, co `make assets` obiecuje.
    // Uzywaja go tylko Dockerfile'e, gdzie `make` nie wystepuje.
    grunt.registerTask('build-non-interactive', [
        'concurrent:themes',
        'shell:linkSitePackages',
        'shell:esbuild',
        'shell:esbuildCytoscape',
        'shell:esbuildThree',
        'shell:patchBundle',
        'shell:copyRollbar'
    ]);

    // Rename the original watch task and create an alias that builds first
    grunt.renameTask('watch', '_watch');
    grunt.registerTask('watch', ['build', '_watch']);
    grunt.registerTask('default', ['watch']);
}