@dbx-tools/projen 0.9.5 → 0.9.7

package/src/barrels.ts

@@ -59,7 +59,7 @@
 import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join, relative } from "node:path";
 import { find } from "@dbx-tools/path";
-import { json, string } from "@dbx-tools/shared-core";
+import { json, stringUtils } from "@dbx-tools/shared-core";
 import isIdentifier from "is-identifier";
 import { header, isGenerated, makeReadonly, makeWritable, type HeaderOpts } from "./generated.ts";
 import { moduleExports, moduleStatements, type ModuleExport } from "./module-exports.ts";
@@ -125,9 +125,11 @@ const UNIFFI_BINDINGS_FILE = "bindings.ts";
 const UNIFFI_GENERATED_FILE = "_bindings.ts";
 const UNIFFI_FFI_FILE = "_bindings-ffi.ts";
 
-/** `pnpm-workspace` -> `pnpmWorkspace`; `local-fs` -> `localFS` (`fs` -> `FS`). */
-function kebabToCamel(segment: string): string {
-  const tokens = [...string.tokenizeWithOptions({ lowerCase: true, capitalize: true }, segment)];
+/** `config-tools` / `config_tools` -> `configTools`; `local-fs` -> `localFS`. */
+function moduleSegmentToCamel(segment: string): string {
+  const tokens = [
+    ...stringUtils.tokenizeWithOptions({ lowerCase: true, capitalize: true }, segment),
+  ];
   if (tokens.length === 0) return segment;
   const [first, ...rest] = tokens;
   // Standalone acronym modules (`fs`, `ai`) stay lowercase so they match
@@ -145,14 +147,14 @@ function modulePathToNamespace(modulePath: string): string {
   const rel = modulePath.replace(/^\.\/src\//, "").replace(/\.(tsx?|jsx?|mjs|cjs)$/, "");
   const segments = rel.split("/");
   if (segments.at(-1) === "index" && segments.length > 1) segments.pop();
-  const names = segments.map(kebabToCamel);
+  const names = segments.map(moduleSegmentToCamel);
   let name =
     names.length === 1
       ? names[0]!
       : names[0]! +
         names
           .slice(1)
-          .map((s) => string.capitalize(s))
+          .map((s) => stringUtils.capitalize(s))
           .join("");
   if (!isIdentifier(name)) {
     name = `${name}Module`;
@@ -521,10 +523,9 @@ const WRITE_ATTEMPTS = 3;
  * and the projenrc watcher's post-synth `generateBarrels()` sweep), so any gap
  * between `makeWritable` and the write is a window in which another process's
  * `makeReadonly` lands and this write fails with
- * `EACCES: permission denied, open '<pkg>/index.ts'`. The gap used to span all of
- * the oxc parsing done for export hoisting, which made it wide enough to hit
- * routinely. Keeping the unlock adjacent to the write shrinks it to nothing much,
- * and a retry absorbs what is left.
+ * `EACCES: permission denied, open '<pkg>/index.ts'`. Keeping the unlock adjacent
+ * to the write avoids a gap during export parsing, and a retry absorbs what is
+ * left.
  *
  * Do NOT "simplify" this back to a single unlock-then-write: the failure is
  * timing-dependent, so it looks fine until a full-repo sweep runs against a
@@ -576,7 +577,7 @@ export function generateBarrels(
     const names = failures.map((f) => relative(projectRoot, f.dir) || f.dir);
     throw new AggregateError(
       failures.map((f) => f.err),
-      `${string.pluralize(failures.length, "barrel")} failed: ${names.join(", ")}`,
+      `${stringUtils.pluralize(failures.length, "barrel")} failed: ${names.join(", ")}`,
     );
   }
   return total;

package/src/bun-app.ts

@@ -23,6 +23,7 @@
  * `src/`), they are outside the package's `tsconfig` include, so their `Bun.*`
  * usage never trips the `app` package's DOM-only `compile`.
  */
+import { stringUtils } from "@dbx-tools/shared-core";
 import { type Project, TextFile } from "projen";
 
 /** Unmanaged dev-server override module, merged over the generated options if present. */
@@ -90,34 +91,38 @@ export class BunfigFile extends TextFile {
 /** `dev.ts`: a `Bun.serve()` fullstack dev server with React HMR. */
 export class BunDevServerFile extends TextFile {
   constructor(project: Project) {
-    super(project, "dev.ts", {
-      marker: true,
-      readonly: true,
-      lines: String.raw`
-import { existsSync } from "node:fs";
-import index from "./index.html";
+    // prettier-ignore
+    const source = (
+      // ============================================================================
+      /*ts*/`
+      import { existsSync } from "node:fs";
+      import index from "./index.html";
 
-// Unmanaged override (${BUN_DEV_OVERRIDE}): its default export is merged over the
-// generated serve options - later wins - so a package tweaks the dev server
-// without editing this generated file.
-let options: Bun.ServeFunctionOptions<unknown, {}> = {
-  port: Number(process.env.PORT ?? 5173),
-  development: { hmr: true, console: true },
-  routes: { "/*": index },
-};
+      // Unmanaged override (${BUN_DEV_OVERRIDE}): its default export is merged over the
+      // generated serve options - later wins - so a package tweaks the dev server
+      // without editing this generated file.
+      let options: Bun.ServeFunctionOptions<unknown, {}> = {
+        port: Number(process.env.PORT ?? 5173),
+        development: { hmr: true, console: true },
+        routes: { "/*": index },
+      };
 
-const overrideUrl = new URL("./${BUN_DEV_OVERRIDE}", import.meta.url);
-if (existsSync(overrideUrl)) {
-  const mod = await import(overrideUrl.href);
-  const override = typeof mod.default === "function" ? await mod.default() : mod.default;
-  options = { ...options, ...override };
-}
+      const overrideUrl = new URL("./${BUN_DEV_OVERRIDE}", import.meta.url);
+      if (existsSync(overrideUrl)) {
+        const mod = await import(overrideUrl.href);
+        const override = typeof mod.default === "function" ? await mod.default() : mod.default;
+        options = { ...options, ...override };
+      }
 
-const server = Bun.serve(options);
-console.log("dev server running at " + server.url.href);
-`
-        .trimStart()
-        .split("\n"),
+      const server = Bun.serve(options);
+      console.log("dev server running at " + server.url.href);
+      `
+      // ============================================================================
+    );
+    super(project, "dev.ts", {
+      marker: true,
+      readonly: true,
+      lines: stringUtils.dedentLines(source, { trimEnd: false }),
     });
   }
 }
@@ -125,73 +130,79 @@ console.log("dev server running at " + server.url.href);
 /** `build.ts`: a `Bun.build()` production bundle (Tailwind via the plugin API). */
 export class BunBuildFile extends TextFile {
   constructor(project: Project) {
-    super(project, "build.ts", {
-      marker: true,
-      readonly: true,
-      lines: String.raw`
-import { existsSync } from "node:fs";
-import { cp, rm } from "node:fs/promises";
-import { basename } from "node:path";
-import tailwind from "bun-plugin-tailwind";
+    // Raw template preserves backslashes in generated regular expression literals.
+    // prettier-ignore
+    const source = (
+      String.raw
+      // ============================================================================
+      /*ts*/`
+      import { existsSync } from "node:fs";
+      import { cp, rm } from "node:fs/promises";
+      import { basename } from "node:path";
+      import tailwind from "bun-plugin-tailwind";
 
-// Unmanaged override (${BUN_BUILD_OVERRIDE}): its default export is merged over
-// the generated build options - later wins.
-let options: Bun.BuildConfig = {
-  entrypoints: ["./index.html"],
-  outdir: "./dist",
-  define: { "process.env.NODE_ENV": JSON.stringify("production") },
-  minify: true,
-  splitting: true,
-  publicPath: "/",
-  external: ["/fonts/*"],
-  sourcemap: "none",
-  plugins: [tailwind],
-};
+      // Unmanaged override (${BUN_BUILD_OVERRIDE}): its default export is merged over
+      // the generated build options - later wins.
+      let options: Bun.BuildConfig = {
+        entrypoints: ["./index.html"],
+        outdir: "./dist",
+        define: { "process.env.NODE_ENV": JSON.stringify("production") },
+        minify: true,
+        splitting: true,
+        publicPath: "/",
+        external: ["/fonts/*"],
+        sourcemap: "none",
+        plugins: [tailwind],
+      };
 
-const overrideUrl = new URL("./${BUN_BUILD_OVERRIDE}", import.meta.url);
-if (existsSync(overrideUrl)) {
-  const mod = await import(overrideUrl.href);
-  const override = typeof mod.default === "function" ? await mod.default() : mod.default;
-  options = { ...options, ...override, plugins: [...(options.plugins ?? []), ...(override.plugins ?? [])] };
-}
+      const overrideUrl = new URL("./${BUN_BUILD_OVERRIDE}", import.meta.url);
+      if (existsSync(overrideUrl)) {
+        const mod = await import(overrideUrl.href);
+        const override = typeof mod.default === "function" ? await mod.default() : mod.default;
+        options = { ...options, ...override, plugins: [...(options.plugins ?? []), ...(override.plugins ?? [])] };
+      }
 
-const outdir = options.outdir ?? "./dist";
-await rm(outdir, { recursive: true, force: true });
+      const outdir = options.outdir ?? "./dist";
+      await rm(outdir, { recursive: true, force: true });
 
-const result = await Bun.build(options);
-if (!result.success) {
-  for (const message of result.logs) console.error(message);
-  process.exit(1);
-}
+      const result = await Bun.build(options);
+      if (!result.success) {
+        for (const message of result.logs) console.error(message);
+        process.exit(1);
+      }
 
-// Fix a Bun bug: with \`splitting: true\` and an HTML entrypoint, the emitted
-// HTML's <script src> is wired to an arbitrary chunk instead of the JS
-// entry-point, so the app never boots (a blank page). Rewrite the HTML script
-// (and stylesheet) to the real entry-point outputs. No-op when they already
-// match (e.g. splitting off), so it is always safe to run.
-const htmlOut = result.outputs.find((o) => o.path.endsWith(".html"));
-const entryJs = result.outputs.find((o) => o.kind === "entry-point" && o.path.endsWith(".js"));
-const entryCss = result.outputs.find((o) => o.kind === "entry-point" && o.path.endsWith(".css"));
-if (htmlOut && entryJs) {
-  let html = await Bun.file(htmlOut.path).text();
-  const jsName = basename(entryJs.path);
-  html = html.replace(/(<script[^>]*\bsrc=")([^"]*\/)?[^"/]+\.js(")/i, "$1$2" + jsName + "$3");
-  if (entryCss) {
-    const cssName = basename(entryCss.path);
-    html = html.replace(/(<link[^>]*\bhref=")([^"]*\/)?[^"/]+\.css(")/i, "$1$2" + cssName + "$3");
-  }
-  await Bun.write(htmlOut.path, html);
-}
+      // Fix a Bun bug: with \`splitting: true\` and an HTML entrypoint, the emitted
+      // HTML's <script src> is wired to an arbitrary chunk instead of the JS
+      // entry-point, so the app never boots (a blank page). Rewrite the HTML script
+      // (and stylesheet) to the real entry-point outputs. No-op when they already
+      // match (e.g. splitting off), so it is always safe to run.
+      const htmlOut = result.outputs.find((o) => o.path.endsWith(".html"));
+      const entryJs = result.outputs.find((o) => o.kind === "entry-point" && o.path.endsWith(".js"));
+      const entryCss = result.outputs.find((o) => o.kind === "entry-point" && o.path.endsWith(".css"));
+      if (htmlOut && entryJs) {
+        let html = await Bun.file(htmlOut.path).text();
+        const jsName = basename(entryJs.path);
+        html = html.replace(/(<script[^>]*\bsrc=")([^"]*\/)?[^"/]+\.js(")/i, "$1$2" + jsName + "$3");
+        if (entryCss) {
+          const cssName = basename(entryCss.path);
+          html = html.replace(/(<link[^>]*\bhref=")([^"]*\/)?[^"/]+\.css(")/i, "$1$2" + cssName + "$3");
+        }
+        await Bun.write(htmlOut.path, html);
+      }
 
-const publicDir = "./public";
-if (existsSync(publicDir)) {
-  await cp(publicDir, outdir, { recursive: true });
-}
+      const publicDir = "./public";
+      if (existsSync(publicDir)) {
+        await cp(publicDir, outdir, { recursive: true });
+      }
 
-console.log("built " + result.outputs.length + " files to " + options.outdir);
-`
-        .trimStart()
-        .split("\n"),
+      console.log("built " + result.outputs.length + " files to " + options.outdir);
+      `
+      // ============================================================================
+    );
+    super(project, "build.ts", {
+      marker: true,
+      readonly: true,
+      lines: stringUtils.dedentLines(source, { trimEnd: false }),
     });
   }
 }

package/src/bun-workflow.ts

@@ -1,4 +1,5 @@
 /** Shared Bun setup and package-cache steps for generated workflows. */
+import { stringUtils } from "@dbx-tools/shared-core";
 import { TextFile, javascript } from "projen";
 
 export const BUN_VERSION = "1.3.14";
@@ -16,61 +17,68 @@ const DEFAULT_CACHE_IGNORE_PATHS = [
 
 function cacheKeyScript(extraIgnorePaths: readonly string[]): string {
   const ignorePaths = [...new Set(extraIgnorePaths)].sort();
-  return `#!/usr/bin/env node
-import { createHash } from "node:crypto";
-import { readdirSync, readFileSync } from "node:fs";
-import { join, sep } from "node:path";
+  // prettier-ignore
+  const source = (
+    // ============================================================================
+    /*js*/`
+  #!/usr/bin/env node
+  import { createHash } from "node:crypto";
+  import { readdirSync, readFileSync } from "node:fs";
+  import { join, sep } from "node:path";
 
-const root = process.cwd();
-const ignoredNames = new Set(${JSON.stringify(DEFAULT_CACHE_IGNORE_PATHS)});
-const ignoredPaths = new Set(${JSON.stringify(ignorePaths)});
-const manifests = [];
-const walk = (directory) => {
-  for (const entry of readdirSync(directory, { withFileTypes: true })) {
-    const path = join(directory, entry.name);
-    const relativePath = path.slice(root.length + 1).split(sep).join("/");
-    if (ignoredNames.has(entry.name) || ignoredPaths.has(relativePath)) continue;
-    if (entry.isDirectory()) walk(path);
-    else if (entry.name === "package.json") manifests.push(path);
-  }
-};
-walk(root);
+  const root = process.cwd();
+  const ignoredNames = new Set(${JSON.stringify(DEFAULT_CACHE_IGNORE_PATHS)});
+  const ignoredPaths = new Set(${JSON.stringify(ignorePaths)});
+  const manifests = [];
+  const walk = (directory) => {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+      const path = join(directory, entry.name);
+      const relativePath = path.slice(root.length + 1).split(sep).join("/");
+      if (ignoredNames.has(entry.name) || ignoredPaths.has(relativePath)) continue;
+      if (entry.isDirectory()) walk(path);
+      else if (entry.name === "package.json") manifests.push(path);
+    }
+  };
+  walk(root);
 
-const dependencyFields = [
-  "catalog",
-  "dependencies",
-  "devDependencies",
-  "optionalDependencies",
-  "overrides",
-  "peerDependencies",
-  "peerDependenciesMeta",
-  "resolutions",
-  "trustedDependencies",
-];
-const canonical = (value) => {
-  if (Array.isArray(value)) return value.map(canonical);
-  if (!value || typeof value !== "object") return value;
-  return Object.fromEntries(
-    Object.entries(value)
-      .sort(([left], [right]) => left.localeCompare(right))
-      .map(([key, child]) => [key, canonical(child)]),
+  const dependencyFields = [
+    "catalog",
+    "dependencies",
+    "devDependencies",
+    "optionalDependencies",
+    "overrides",
+    "peerDependencies",
+    "peerDependenciesMeta",
+    "resolutions",
+    "trustedDependencies",
+  ];
+  const canonical = (value) => {
+    if (Array.isArray(value)) return value.map(canonical);
+    if (!value || typeof value !== "object") return value;
+    return Object.fromEntries(
+      Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, child]) => [key, canonical(child)]),
+    );
+  };
+  const dependencies = manifests
+    .sort()
+    .map((path) => {
+      const manifest = JSON.parse(readFileSync(path, "utf8"));
+      return [
+        path.slice(root.length + 1),
+        Object.fromEntries(
+          dependencyFields
+            .filter((field) => manifest[field] !== undefined)
+            .map((field) => [field, canonical(manifest[field])]),
+        ),
+      ];
+    });
+  process.stdout.write(createHash("sha256").update(JSON.stringify(dependencies)).digest("hex"));
+  `
+    // ============================================================================
   );
-};
-const dependencies = manifests
-  .sort()
-  .map((path) => {
-    const manifest = JSON.parse(readFileSync(path, "utf8"));
-    return [
-      path.slice(root.length + 1),
-      Object.fromEntries(
-        dependencyFields
-          .filter((field) => manifest[field] !== undefined)
-          .map((field) => [field, canonical(manifest[field])]),
-      ),
-    ];
-  });
-process.stdout.write(createHash("sha256").update(JSON.stringify(dependencies)).digest("hex"));
-`;
+  return stringUtils.dedent(source, { trimEnd: false });
 }
 
 const configured = new WeakMap<javascript.NodeProject, string>();

package/src/engine-root.ts

@@ -6,8 +6,8 @@
  */
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { project } from "@dbx-tools/core";
-import { functionModule } from "@dbx-tools/shared-core";
+import * as projectUtils from "@dbx-tools/core/project-utils";
+import { functionUtils } from "@dbx-tools/shared-core";
 
 const ENGINE_PKG = "@dbx-tools/projen";
 
@@ -17,11 +17,11 @@ const ENGINE_PKG = "@dbx-tools/projen";
  * Walks up from this module with shared-core's {@link project.root} (the nearest
  * package bounded by the enclosing npm/git root), so it resolves both in-repo and
  * when installed as a dependency. Memoized with shared-core's
- * {@link functionModule.memoize}, which caches only a successful result - a
+ * {@link functionUtils.memoize}, which caches only a successful result - a
  * throw is retried on the next call.
  */
-export const resolvePkgRoot = functionModule.memoize((): string => {
-  const found = project.root(dirname(fileURLToPath(import.meta.url)));
+export const resolvePkgRoot = functionUtils.memoize((): string => {
+  const found = projectUtils.root(dirname(fileURLToPath(import.meta.url)));
   if (!found) throw new Error(`${ENGINE_PKG} package root not found`);
   return found;
 });

package/src/openapi.ts

@@ -35,9 +35,9 @@ import {
 import { createRequire } from "node:module";
 import { join } from "node:path";
 import { promisify } from "node:util";
-import { bin } from "@dbx-tools/core";
+import * as bin from "@dbx-tools/core/bin";
 import { find } from "@dbx-tools/path";
-import { log } from "@dbx-tools/shared-core";
+import { log, stringUtils } from "@dbx-tools/shared-core";
 import type * as ts from "typescript";
 import { lazyRequire } from "./_lazy-require.ts";
 import { makeReadonly, makeWritable, stampGenerated } from "./generated.ts";
@@ -61,14 +61,21 @@ const SPEAKEASY_OPENAPI_VERSION = "1.24.0";
 const SPEAKEASY_OPENAPI_RELEASE_URL = `https://github.com/speakeasy-api/openapi/releases/download/v${SPEAKEASY_OPENAPI_VERSION}`;
 const execFileAsync = promisify(execFile);
 
-const CLIENT_SRC = `import createClient, { type ClientOptions } from "openapi-fetch";
-import type { paths } from "./schema";
+// prettier-ignore
+const CLIENT_TEMPLATE = (
+  // ============================================================================
+  /*ts*/`
+  import createClient, { type ClientOptions } from "openapi-fetch";
+  import type { paths } from "./schema";
 
-/** Create a typed OpenAPI client (openapi-fetch); safe to use in the browser. */
-export function createApiClient(options?: ClientOptions) {
-  return createClient<paths>(options);
-}
-`;
+  /** Create a typed OpenAPI client (openapi-fetch); safe to use in the browser. */
+  export function createApiClient(options?: ClientOptions) {
+    return createClient<paths>(options);
+  }
+  `
+  // ============================================================================
+);
+const CLIENT_SRC = stringUtils.dedent(CLIENT_TEMPLATE, { trimEnd: false });
 
 /** True if any module file in `<pkg>/src` matches {@link TSOA_IMPORT}. */
 function hasTsoaControllers(pkg: Pick<RecordedPackage, "dir">): boolean {

package/src/packages.ts

@@ -25,14 +25,14 @@
  */
 import { existsSync, readFileSync } from "node:fs";
 import { extname, relative, resolve, sep } from "node:path";
-import { project as coreProject } from "@dbx-tools/core";
+import * as projectUtils from "@dbx-tools/core/project-utils";
 import { find } from "@dbx-tools/path";
-import { json, object, string } from "@dbx-tools/shared-core";
+import { json, object, stringUtils } from "@dbx-tools/shared-core";
 import { parse } from "yaml";
 
 /** Resolve the nearest package/projenrc root at call time. */
 export function resolveRepoRoot(cwd: string = process.cwd()): string {
-  return coreProject.root(cwd) ?? cwd;
+  return projectUtils.root(cwd) ?? cwd;
 }
 
 /** Current-process repository root for executable task entrypoints. */
@@ -47,11 +47,11 @@ export const DEFAULT_PACKAGE_ROOTS = ["packages"] as const;
 /**
  * A project name: the root `package.json` name, else the git remote's repo
  * name, else the root folder name. Delegates to `@dbx-tools/core`'s
- * {@link coreProject.name}, which is also what a consuming repo's own tooling
+ * {@link projectUtils.name}, which is also what a consuming repo's own tooling
  * sees, so the engine and its host agree on the name.
  */
 export function projectName(projectRoot: string = resolveRepoRoot()): string {
-  return coreProject.name(projectRoot);
+  return projectUtils.name(projectRoot);
 }
 
 const MODULE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
@@ -65,7 +65,7 @@ export function toPosix(p: string): string {
 
 /**
  * Cumulative nesting tags from a package's path segments relative to its discovery
- * root. Each segment is kebab-cased with {@link string.toSlug} (`coolDude` ->
+ * root. Each segment is kebab-cased with {@link stringUtils.toSlug} (`coolDude` ->
  * `cool-dude`). The leaf folder (the package name) is excluded when there are two
  * or more segments; a lone segment tags itself.
  */
@@ -75,7 +75,7 @@ function nestingTagsFromSegments(segments: readonly string[]): string[] {
   const out: string[] = [];
   let acc = "";
   for (const segment of prefix) {
-    const token = string.toSlug(segment);
+    const token = stringUtils.toSlug(segment);
     if (!token) continue;
     acc = acc ? `${acc}-${token}` : token;
     out.push(acc);
@@ -288,7 +288,7 @@ function readManifestTags(dir: string): string[] | undefined {
  */
 export function syncResynthPaths(projectRoot: string = resolveRepoRoot()): string[] {
   const paths = readDbxToolsConfig(projectRoot)?.syncResynthPaths;
-  return Array.isArray(paths) ? string.parseList(paths.map((p) => String(p))) : [];
+  return Array.isArray(paths) ? stringUtils.parseList(paths.map((p) => String(p))) : [];
 }
 
 /**
@@ -322,7 +322,7 @@ export function recordedPackages(projectRoot: string = resolveRepoRoot()): Recor
 export function recordedRoots(projectRoot: string = resolveRepoRoot()): string[] {
   const configured = readDbxToolsConfig(projectRoot)?.packageRoots;
   if (Array.isArray(configured)) {
-    const roots = string.parseList(configured.map((root) => String(root)));
+    const roots = stringUtils.parseList(configured.map((root) => String(root)));
     if (roots.length) return roots;
   }
   const roots = new Set<string>(DEFAULT_PACKAGE_ROOTS);

package/src/pnpm-workspace.ts

@@ -2,7 +2,7 @@
  * Inputs for `pnpm-workspace.yaml`, which projen's NATIVE
  * `javascript.PnpmWorkspaceYaml` owns.
  *
- * projen (>= 0.101.16) writes this file itself: every pnpm `NodeProject` gets a
+ * projen writes this file itself: every pnpm `NodeProject` gets a
  * `PnpmWorkspaceYaml` component typed by `PnpmWorkspaceYamlSchema`, fed from
  * `pnpmOptions.workspaceYamlOptions`. Nothing here writes a file; this only
  * supplies the options object it renders, so the whole pnpm schema (`overrides`,