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_url_params.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_bigint_assert.c", all("assert", "bigint")],
  ["scr_qs.c", "qs"],
  ["scr_util.c", "parseArgs"],
  // Utility objects must only reference runtime families selected with them.
  ["scr_util_compare.c", all("parseArgs", "symbol")],
  ["scr_util_style.c", all("parseArgs", "inspect", "dynAsync")],
  ["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;
}