Setting up the build system

npm install --save-dev @types/node

npm install --save-dev @enonic-types/core @enonic-types/global @enonic-types/lib-admin @enonic-types/lib-app @enonic-types/lib-auditlog @enonic-types/lib-auth @enonic-types/lib-cluster @enonic-types/lib-common @enonic-types/lib-content @enonic-types/lib-context @enonic-types/lib-event @enonic-types/lib-export @enonic-types/lib-grid @enonic-types/lib-i18n @enonic-types/lib-io @enonic-types/lib-mail @enonic-types/lib-node @enonic-types/lib-portal @enonic-types/lib-project @enonic-types/lib-repo @enonic-types/lib-schema @enonic-types/lib-scheduler @enonic-types/lib-sse @enonic-types/lib-task @enonic-types/lib-value @enonic-types/lib-vhost @enonic-types/lib-websocket

[versions]
static = "3.0.0"

[libraries]
static = { module = "com.enonic.lib:lib-static", version.ref = "static" }

dependencies {
  include xplibs.portal
  include libs.static
}

npm install --save-dev @enonic-types/lib-static

declare global {
  interface XpLibraries {
    '/lib/enonic/static': typeof import('@enonic-types/lib-static');
  }
}

export {};

npm install --save-dev typescript tsdown glob concurrently

{
  "scripts": {
    "build": "tsdown"
  }
}

{
  "private": true
}

{
  // This file should only include files that configures the build system.
  // It should ignore all actual source files.

  // Read more about tsconfig.json at:
  // https://www.typescriptlang.org/tsconfig

  // Specifies an array of filenames or patterns to include in the program.
  // These filenames are resolved relative to the directory containing the
  // tsconfig.json file.
  "include": [
    "**/*.ts"
  ],

  // Specifies an array of filenames or patterns that should be skipped when
  // resolving include.
  // Important: exclude only changes which files are included as a result of
  // the include setting. A file specified by exclude can still become part of
  // your codebase due to an import statement in your code, a types inclusion,
  // a /// <reference directive, or being specified in the files list.
  // It is not a mechanism that prevents a file from being included in the
  // codebase - it simply changes what the include setting finds.
  "exclude": [
    "**/*.d.ts",
    "src/**/*.*", // Avoid Enonic XP source files
  ],

  "compilerOptions": {
    // Leave baseUrl unset: setting it would let bare module specifiers resolve
    // against the project root instead of node_modules, which can shadow real
    // packages with same-named local folders.
    // "baseUrl": ".",

    "lib": [
      "es2023" // string.replaceAll
    ],

    // By default all visible ”@types” packages are included in your compilation.
    // Packages in node_modules/@types of any enclosing folder are considered visible.
    // For example, that means packages within ./node_modules/@types/,
    // ../node_modules/@types/, ../../node_modules/@types/, and so on.
    // If types is specified, only packages listed will be included in the global scope.
    // This feature differs from typeRoots in that it is about specifying only the exact
    // types you want included, whereas typeRoots supports saying you want particular folders.
    "types": [
      "node"
    ],
    // tsdown's types reference `exports`-subpath imports and ship .d.ts using
    // private (#) fields; these let the build config type-check cleanly.
    "skipLibCheck": true,
    "module": "preserve",
    "moduleResolution": "bundler"
  },
}

{
  // This file should only include Enonic XP server-side source files.
  // It should exclude any client-side source files.

  // Read more about tsconfig.json at:
  // https://www.typescriptlang.org/tsconfig

  // Specifies an array of filenames or patterns to include in the program.
  // These filenames are resolved relative to the directory containing the
  // tsconfig.json file.
  "include": [
    "**/*.ts"
  ],

  // Specifies an array of filenames or patterns that should be skipped when
  // resolving include.
  // Important: exclude only changes which files are included as a result of
  // the include setting. A file specified by exclude can still become part of
  // your codebase due to an import statement in your code, a types inclusion,
  // a /// <reference directive, or being specified in the files list.
  // It is not a mechanism that prevents a file from being included in the
  // codebase - it simply changes what the include setting finds.
  "exclude": [
    "**/*.d.ts",
    "assets/**/*.*",
    // "static/**/*.*",
  ],

  "compilerOptions": {
    // A series of entries which re-map imports to lookup locations relative
    // to the baseUrl if set, or to the tsconfig file itself otherwise.
    "paths": {
      // Explicit per-library entries (rather than only the "/lib/xp/*"
      // wildcard) let the IDE's auto-import suggest the runtime-correct
      // "/lib/xp/<name>" specifiers. See also autoImportSpecifierExcludeRegexes
      // in .vscode/settings.json. Add an entry when installing a new
      // @enonic-types/lib-* package.
      "/lib/xp/admin": ["../../../node_modules/@enonic-types/lib-admin/admin"],
      "/lib/xp/app": ["../../../node_modules/@enonic-types/lib-app/app"],
      "/lib/xp/auditlog": ["../../../node_modules/@enonic-types/lib-auditlog/auditlog"],
      "/lib/xp/auth": ["../../../node_modules/@enonic-types/lib-auth/auth"],
      "/lib/xp/cluster": ["../../../node_modules/@enonic-types/lib-cluster/cluster"],
      "/lib/xp/common": ["../../../node_modules/@enonic-types/lib-common/common"],
      "/lib/xp/content": ["../../../node_modules/@enonic-types/lib-content/content"],
      "/lib/xp/context": ["../../../node_modules/@enonic-types/lib-context/context"],
      "/lib/xp/event": ["../../../node_modules/@enonic-types/lib-event/event"],
      "/lib/xp/export": ["../../../node_modules/@enonic-types/lib-export/export"],
      "/lib/xp/grid": ["../../../node_modules/@enonic-types/lib-grid/grid"],
      "/lib/xp/i18n": ["../../../node_modules/@enonic-types/lib-i18n/i18n"],
      "/lib/xp/io": ["../../../node_modules/@enonic-types/lib-io/io"],
      "/lib/xp/mail": ["../../../node_modules/@enonic-types/lib-mail/mail"],
      "/lib/xp/node": ["../../../node_modules/@enonic-types/lib-node/node"],
      "/lib/xp/portal": ["../../../node_modules/@enonic-types/lib-portal/portal"],
      "/lib/xp/project": ["../../../node_modules/@enonic-types/lib-project/project"],
      "/lib/xp/repo": ["../../../node_modules/@enonic-types/lib-repo/repo"],
      "/lib/xp/scheduler": ["../../../node_modules/@enonic-types/lib-scheduler/scheduler"],
      "/lib/xp/schema": ["../../../node_modules/@enonic-types/lib-schema/schema"],
      "/lib/xp/sse": ["../../../node_modules/@enonic-types/lib-sse/sse"],
      "/lib/xp/task": ["../../../node_modules/@enonic-types/lib-task/task"],
      "/lib/xp/value": ["../../../node_modules/@enonic-types/lib-value/value"],
      "/lib/xp/vhost": ["../../../node_modules/@enonic-types/lib-vhost/vhost"],
      "/lib/xp/websocket": ["../../../node_modules/@enonic-types/lib-websocket/websocket"],
      "/lib/xp/*": ["../../../node_modules/@enonic-types/lib-*"],
      "/*": ["./*"],
    },

    "skipLibCheck": true,

    // By default all visible ”@types” packages are included in your compilation.
    // Packages in node_modules/@types of any enclosing folder are considered visible.
    // For example, that means packages within ./node_modules/@types/,
    // ../node_modules/@types/, ../../node_modules/@types/, and so on.
    // If types is specified, only packages listed will be included in the global scope.
    // This feature differs from typeRoots in that it is about specifying only the exact
    // types you want included, whereas typeRoots supports saying you want particular folders.
    "types": [
      // Make the types for the Enonic XP Global objects and functions
      // available in the global scope.
      // https://developer.enonic.com/docs/xp/stable/framework/globals
      // app, exports, log, require, resolve
      // https://developer.enonic.com/docs/xp/stable/framework/java-bridge
      // __.newBean, __.toNativeObject, __.nullOrValue
      "@enonic-types/global"
    ],
  },
}

{
  // This file configures TypeScript for client-side assets.

  // Read more about tsconfig.json at:
  // https://www.typescriptlang.org/tsconfig

  // Specifies an array of filenames or patterns to include in the program.
  // These filenames are resolved relative to the directory containing the
  // tsconfig.json file.
  "include": [
    "./**/*.ts",
    "./**/*.tsx",
  ],

  // Specifies an array of filenames or patterns that should be skipped when
  // resolving include.
  // Important: exclude only changes which files are included as a result of
  // the include setting. A file specified by exclude can still become part of
  // your codebase due to an import statement in your code, a types inclusion,
  // a /// <reference directive, or being specified in the files list.
  // It is not a mechanism that prevents a file from being included in the
  // codebase - it simply changes what the include setting finds.
  "exclude": [
    "./**/*.d.ts",
  ],

  "compilerOptions": {
    "lib": [
      "DOM", // console, document, window, etc...
    ],
  },
}

import {existsSync} from 'node:fs';

import {transform} from '@swc/core';
import {globSync} from 'glob';
import {defineConfig} from 'tsdown';


const SRC = 'src/main/resources';
const SRC_ASSETS = `${SRC}/assets`;
const DST = 'build/resources/main';
const DST_ASSETS = `${DST}/assets`;

const dev = process.env.NODE_ENV === 'development';
const logLevel: 'silent' | 'info' = ['QUIET', 'WARN'].includes(process.env.LOG_LEVEL_FROM_GRADLE || '') ? 'silent' : 'info';

// Enonic XP loads each controller/service/task by its resource path, so every
// source file must become its own output file with the directory tree intact.
// Turn a glob into a tsdown `entry` map ({ "relative/name": "src/path/file.ts" }).
function entries(dir: string, exts: string, ignore: string[] = []): Record<string, string> {
  return Object.fromEntries(
    globSync(`${dir}/**/*.${exts}`, {posix: true, ignore})
      .map(file => [file.slice(dir.length + 1).replace(/\.[^.]+$/, ''), file]),
  );
}

const serverEntry = entries(SRC, '{ts,js}', [`${SRC_ASSETS}/**`]);
const assetEntry = entries(SRC_ASSETS, '{tsx,ts,jsx,js}');

// XP resolves an absolute import at runtime against the app's own resources
// first, then against the modules provided by the runtime: XP's own libraries
// (/lib/xp/*), libraries `include`d in build.gradle, modules from other apps.
// Mirror that rule at build time: bundle an absolute import only when it is a
// source file of this app, and leave every other one to the runtime — no list
// of runtime modules to maintain. A mistyped specifier is caught by
// `check:types` (TS2307), not by the bundler.
const SRC_EXTS = ['.ts', '.tsx', '.js', '.jsx'];
function isAppSource(id: string): boolean {
  return SRC_EXTS.some(ext => existsSync(`${SRC}${id}${ext}`) || existsSync(`${SRC}${id}/index${ext}`));
}
const isRuntimeModule = (id: string, _importer: string | undefined, isResolved: boolean): boolean =>
  !isResolved && id.startsWith('/') && !isAppSource(id);

// Nashorn (XP's server-side JS engine) lacks ES2015 destructuring, but Oxc —
// tsdown's transformer — can't target below es2015. Re-lower the bundled server
// output to es5 with SWC after bundling, so bundled deps are covered too.
const nashornEs5 = {
  name: 'nashorn-es5',
  async renderChunk(code: string) {
    const out = await transform(code, {
      jsc: {
        parser: {syntax: 'ecmascript'},
        target: 'es5',
        loose: true,
        externalHelpers: false,
      },
      isModule: false,
      minify: false,
      sourceMaps: false,
    });
    return {code: out.code, map: null};
  },
};

// Skip a target that has no source files (e.g. a server-only or client-only app).
export default defineConfig([
  ...(Object.keys(serverEntry).length ? [{
    entry: serverEntry,
    outDir: DST,
    format: 'cjs' as const,
    target: 'es2015', // Rolldown/oxc floor; nashornEs5 plugin re-lowers to es5 for Nashorn
    platform: 'neutral' as const,
    clean: false, // outDir also holds Gradle-copied resources + the assets/ subfolder
    dts: false, // d.ts files are useless at runtime
    minify: false, // minifying server files makes debugging harder
    sourcemap: false,
    logLevel,
    plugins: [nashornEs5],
    tsconfig: `${SRC}/tsconfig.json`,
    inputOptions: {
      external: isRuntimeModule,
      resolve: {
        mainFields: ['module', 'main'],
      },
    },
    outputOptions: {
      chunkFileNames: '_chunks/[name]-[hash].js', // avoid chunk-name collisions
    },
  }] : []),
  ...(Object.keys(assetEntry).length ? [{
    entry: assetEntry,
    outDir: DST_ASSETS,
    format: 'esm' as const,
    target: 'es2015',
    platform: 'browser' as const,
    clean: false,
    dts: false,
    minify: !dev,
    sourcemap: dev,
    logLevel,
    tsconfig: `${SRC_ASSETS}/tsconfig.json`,
  }] : []),
]);

plugins {
  id 'com.enonic.xp.app'                            // already present
  id 'com.github.node-gradle.node' version '7.1.0'  // add this
}

node {
  // Whether to download and install a specific Node.js version or not
  // If false, it will use the globally installed Node.js
  // If true, it will download node using above parameters
  // Note that npm is bundled with Node.js
  download = true

  // Version of node to download and install (only used if download is true)
  // It will be unpacked in the workDir
  version = '24.11.0'
}

tasks.register('npmBuild', NpmTask) {
  args = [
    'run',
    '--silent',
    'build'
  ]
  dependsOn npmInstall
  environment = [
    'FORCE_COLOR': 'true',
    'LOG_LEVEL_FROM_GRADLE': gradle.startParameter.logLevel.toString(),
    'NODE_ENV': project.findProperty('env') == 'dev' ? 'development' : 'production'
  ]
  inputs.dir 'src/main/resources'
  outputs.dir 'build/resources/main'
  outputs.upToDateWhen { false }
}

jar.dependsOn npmBuild

tasks.withType(Copy).configureEach {
  includeEmptyDirs = false
}

processResources {
  exclude '**/.gitkeep'
  exclude '**/*.json'
  exclude '**/*.ts'
  exclude '**/*.tsx'
}