scriptc/packages/runtime-pack-common/runtime-pack-matrix.mjs

import { withLibraryRuntimeFlavors } from "./library-matrix.mjs";

/**
 * Shared release-runtime pack matrix. Platform package scripts provide the
 * target descriptor, then this module fixes feature reachability and the
 * compile/link flags required by every generated runtime object.
 */
const any = (...features) => ({ any: features });
const all = (...features) => ({ all: features });

const BASE_RUNTIME_SOURCES = [
  "scr_number.c", "scr_bigint.c", "scr_string.c", "scr_grapheme.c", "scr_array.c", "scr_bytes.c",
  "scr_bytes_io.c", "scr_map.c", "scr_closure.c", "scr_ffi.c",
  "scr_object.c", "scr_union.c", "scr_exception.c", "scr_error.c",
  "scr_console.c", "scr_lib.c", "scr_path.c", "scr_url.c", "scr_json.c", "scr_node_builtin.c",
  "scr_async.c", "scr_crypto_async.c", "scr_child.c", "scr_cycle.c",
];

const OPTIONAL = [
  ["scr_copying.c", "copying"], ["scr_file_handle.c", "fileHandle"],
  ["scr_regex.c", "regex"], ["scr_assert.c", any("assert", "regex", "symbol")],
  ["scr_inspect.c", "inspect"], ["scr_console_native.c", "inspect"], ["scr_dyn_invoke.c", any("dynInvoke", "nativeFetch")],
  ["scr_dc.c", "dc"], ["scr_async_dyn.c", any("dynAsync", "dynInvoke", "dc", "fileHandle", "nativeFetch")],
  ["scr_zlib.c", "zlib"], ["scr_zlib_island.c", all("zlib", "dynamic")],
  ["scr_events.c", "events"], ["scr_readline.c", "events"],
  ["scr_events_emitter.c", "emitter"], ["scr_dyn_handle.c", any("emitter", "netEffective")],
  ["scr_symbol.c", "symbol"], ["scr_url_params.c", "searchParams"],
  ["scr_bigint_assert.c", all("assert", "bigint")],
  ["scr_qs.c", "qs"], ["scr_util.c", "parseArgs"], ["scr_stream.c", "stream"],
  ["scr_loop_kqueue.c", any("netEffective", "dgram")],
  ["scr_loop_epoll.c", any("netEffective", "dgram")],
  ["scr_loop_wsapoll.c", any("netEffective", "dgram")],
  ["scr_net.c", "netEffective"], ["scr_http.c", "httpEffective"],
  ["scr_http2.c", "http2"], ["scr_dgram.c", "dgram"], ["scr_watch.c", "watch"],
  ["scr_ffi_queue.c", "foreignFfi"], ["scr_test.c", "nodeTest"],
  ["scr_tls_ca.c", "tlsCaEffective"], ["scr_tls.c", "tlsEffective"],
  ["scr_fetch.c", "nativeFetch"], ["scr_island.c", "dynamic"],
  ["scr_web.c", "dynamic"], ["scr_inspect_island.c", all("dynamic", "inspect")],
  ["scr_net_island.c", "netIslandEffective"],
];

function variantsFor(source) {
  const dynamicOnly = new Set([
    "scr_zlib_island.c", "scr_island.c", "scr_web.c",
    "scr_inspect_island.c", "scr_net_island.c",
  ]);
  if (dynamicOnly.has(source)) {
    return [{ id: "dynamic", when: { dynamic: true }, defines: ["SCR_DYNAMIC"] }];
  }
  const variants = [{ id: "default", when: {}, defines: [] }];
  if (source === "scr_bytes.c") {
    variants.push({ id: "text-decoder-legacy", when: { textDecoderLegacy: true }, defines: ["SCR_TEXT_DECODER_LEGACY"] });
  }
  variants.push({ id: "dynamic", when: { dynamic: true }, defines: ["SCR_DYNAMIC"] });
  if (source === "scr_bytes.c") {
    variants.push({
      id: "dynamic-text-decoder-legacy", when: { dynamic: true, textDecoderLegacy: true },
      defines: ["SCR_DYNAMIC", "SCR_TEXT_DECODER_LEGACY"],
    });
  }
  return variants;
}

export function createRuntimePackMatrix({
  target,
  compileFlags,
  systemLibraries,
  extraRuntimeSources = [],
  omitRuntimeSources = [],
  omitOptionalSources = [],
  omitArchives = [],
  libraryOnly = false,
}) {
  const vendorArchives = [
    { id: "quickjs", predicate: "dynamic" },
    { id: "libregexp", predicate: { all: ["regex"], not: ["dynamic"] } },
    { id: "zlib", predicate: "zlibEffective" },
    { id: "mbedtls", predicate: "tlsEffective" },
  ];
  const matrix = withLibraryRuntimeFlavors({
    schema: "scriptc.runtime-pack-matrix.v1",
    target,
    flavors: { release: { optimization: "-O2" }, dev: { optimization: "-O0" } },
    executable_section_elimination: { compile_flags: compileFlags },
    runtime_units: [
      ...BASE_RUNTIME_SOURCES
        .filter((source) => !omitRuntimeSources.includes(source))
        .map((source) => ({ source, predicate: true })),
      ...extraRuntimeSources.map((source) => ({ source, predicate: true })),
      ...OPTIONAL
        .filter(([source]) => !omitOptionalSources.includes(source))
        .map(([source, predicate]) => ({ source, predicate })),
    ].map((unit) => ({ ...unit, variants: variantsFor(unit.source) })),
    archives: vendorArchives.filter(({ id }) => !omitArchives.includes(id)),
    system_libraries: systemLibraries,
  });
  if (libraryOnly) {
    matrix.flavors = Object.fromEntries(Object.entries(matrix.flavors).filter(([name]) => name.startsWith("library-")));
    matrix.archives = matrix.archives.filter(({ id }) => id === "libregexp" || id === "zlib");
  }
  return matrix;
}