chore: migrate schema.js to ESM

package.json

@@ -48,6 +48,7 @@
     "scripts/embed-manifest",
     "scripts/init.mjs",
     "scripts/parseargs.mjs",
+    "scripts/schema.mjs",
     "scripts/template.mjs",
     "test-app.gradle",
     "test_app.rb",

scripts/affected.mjs

@@ -1,6 +1,4 @@
-#!/usr/bin/env node
 // @ts-check
-
 import yaml from "js-yaml";
 import { Minimatch } from "minimatch";
 import { spawnSync } from "node:child_process";

scripts/copy-yarnrc.mjs

@@ -1,6 +1,4 @@
-#!/usr/bin/env node
 // @ts-check
-
 import yaml from "js-yaml";
 import * as fs from "node:fs";
 import * as path from "node:path";

scripts/embed-manifest/validate.mjs

@@ -2,7 +2,7 @@
 import Ajv from "ajv";
 import * as nodefs from "node:fs";
 import { readJSONFile } from "../helpers.js";
-import { generateSchema } from "../schema.js";
+import { generateSchema } from "../schema.mjs";
 
 const APP_JSON = "app.json";
 

scripts/generate-manifest-docs.mjs

@@ -1,9 +1,7 @@
-#!/usr/bin/env node
 // @ts-check
-
 import * as path from "node:path";
 import { readDocumentation } from "./generate-schema.mjs";
-import { generateSchema } from "./schema.js";
+import { generateSchema } from "./schema.mjs";
 
 async function generateManifestDocs() {
   const docs = await readDocumentation();

scripts/generate-manifest.mjs

@@ -1,10 +1,8 @@
-#!/usr/bin/env node
 // @ts-check
-
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
-import { generateSchema } from "./schema.js";
+import { generateSchema } from "./schema.mjs";
 
 /**
  * @typedef {import("ajv").SchemaObject} SchemaObject

scripts/generate-schema.mjs

@@ -1,20 +1,26 @@
-#!/usr/bin/env node
 // @ts-check
-
 import * as fs from "node:fs/promises";
 import * as os from "node:os";
 import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { generateSchema } from "./schema.js";
+import { URL, fileURLToPath } from "node:url";
+import { isMain } from "./helpers.js";
+import { generateSchema } from "./schema.mjs";
+
+/** @typedef {import("./types").Docs} Docs */
 
-const thisScript = fileURLToPath(import.meta.url);
-const docsDir = path.join(path.dirname(thisScript), "docs");
+/** @type {(str: string) => string} */
+const stripCarriageReturn =
+  os.EOL === "\r\n" ? (str) => str.replace(/\r/g, "") : (str) => str;
 
 /**
- * @returns {Promise<import("./schema.js").Docs>}
+ * @returns {Promise<Partial<Docs>>}
  */
 export async function readDocumentation() {
-  /** @type {(keyof import("./schema.js").Docs)[]} */
+  /** @type {Partial<Docs>} */
+  const docs = {};
+  const docsDir = fileURLToPath(new URL("docs", import.meta.url));
+
+  /** @type {(keyof Docs)[]} */
   const keys = [
     "introduction",
     "bundleRoot",
@@ -40,29 +46,23 @@ export async function readDocumentation() {
     "windows.certificateThumbprint",
   ];
 
-  const docs = /** @type {import("./schema.js").Docs} */ ({});
-
   for (const name of keys) {
     const filename = path.join(docsDir, name + ".md");
     const md = await fs.readFile(filename, { encoding: "utf-8" });
-    docs[name] = trimCarriageReturn(md).trim();
+    docs[name] = stripCarriageReturn(md).trim();
   }
 
   return docs;
 }
 
-/** @type {(s: string) => string} */
-const trimCarriageReturn =
-  os.EOL === "\r\n" ? (str) => str.replace(/\r/g, "") : (str) => str;
-
-if (process.argv[1] === thisScript) {
+if (isMain(import.meta.url)) {
   readDocumentation()
     .then((docs) => generateSchema(docs))
     .then((schema) => {
       for (const def of Object.values(schema.$defs)) {
         delete def["exclude-from-codegen"];
       }
-      return trimCarriageReturn(JSON.stringify(schema, undefined, 2)) + "\n";
+      return stripCarriageReturn(JSON.stringify(schema, undefined, 2)) + "\n";
     })
     .then((schema) => fs.writeFile("schema.json", schema))
     .catch(console.error);

scripts/schema.js → scripts/schema.mjs

@@ -1,6 +1,8 @@
-/**
- * @typedef {import("./types").Docs} Docs
- */
+// @ts-check
+import { URL, fileURLToPath } from "node:url";
+import { readJSONFile } from "./helpers.js";
+
+/** @typedef {import("./types").Docs} Docs */
 
 /**
  * @param {string} content
@@ -11,12 +13,17 @@ function extractBrief(content = "") {
   return endBrief > 0 ? content.substring(0, endBrief) : content;
 }
 
+function readManifest() {
+  const manifest = fileURLToPath(new URL("../package.json", import.meta.url));
+  return /** @type {import("../package.json")} */ (readJSONFile(manifest));
+}
+
 /**
  * @param {Partial<Docs>=} docs App manifest documentation
  * @returns {import("ajv").SchemaObject}
  */
-function generateSchema(docs = {}) {
-  const { defaultPlatformPackages } = require("../package.json");
+export function generateSchema(docs = {}) {
+  const { defaultPlatformPackages } = readManifest();
   return {
     $defs: {
       appIconSet: {
@@ -330,5 +337,3 @@ function generateSchema(docs = {}) {
     },
   };
 }
-
-exports.generateSchema = generateSchema;

scripts/set-react-version.mjs

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 // @ts-check
 
 /**

scripts/template.mjs

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Joins all specified lines into a single string.
  * @param {...string} lines

scripts/test-e2e.mjs

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 // @ts-check
 
 /**

scripts/test-matrix.mjs

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 // @ts-check
 
 /**

test/pack.test.mjs

@@ -194,7 +194,7 @@ describe("npm pack", () => {
       "scripts/helpers.js",
       "scripts/init.mjs",
       "scripts/parseargs.mjs",
-      "scripts/schema.js",
+      "scripts/schema.mjs",
       "scripts/template.mjs",
       "test-app.gradle",
       "test_app.rb",