@matter/tools 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/building/cli.js

@@ -0,0 +1,100 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cli_exports = {};
+__export(cli_exports, {
+  main: () => main
+});
+module.exports = __toCommonJS(cli_exports);
+var import_yargs = __toESM(require("yargs"), 1);
+var import_helpers = require("yargs/helpers");
+var import_builder = require("./builder.js");
+var import_graph = require("./graph.js");
+var import_project = require("./project.js");
+var import_tsconfig = require("./tsconfig.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Mode = /* @__PURE__ */ ((Mode2) => {
+  Mode2[Mode2["BuildProject"] = 0] = "BuildProject";
+  Mode2[Mode2["BuildProjectWithDependencies"] = 1] = "BuildProjectWithDependencies";
+  Mode2[Mode2["BuildWorkspace"] = 2] = "BuildWorkspace";
+  Mode2[Mode2["DisplayGraph"] = 3] = "DisplayGraph";
+  Mode2[Mode2["SyncTsconfigs"] = 4] = "SyncTsconfigs";
+  return Mode2;
+})(Mode || {});
+async function main(argv = process.argv) {
+  const targets = Array();
+  let mode = 0 /* BuildProject */;
+  const args = await (0, import_yargs.default)((0, import_helpers.hideBin)(argv)).usage("Builds packages adhering to matter.js standards.").option("prefix", { alias: "p", default: ".", type: "string", describe: "specify build directory" }).option("clean", { alias: "c", default: false, type: "boolean", describe: "clean before build" }).option("workspaces", { alias: "w", default: false, type: "boolean", describe: "build all workspace packages" }).option("dependencies", { alias: "d", default: false, type: "boolean", describe: "build dependencies" }).command("*", "build types and both JS files", () => {
+  }).command("clean", "remove build and dist directories", () => targets.push(import_builder.Target.clean)).command("types", "build type definitions", () => targets.push(import_builder.Target.types)).command("esm", "build JS (ES6 modules)", () => targets.push(import_builder.Target.esm)).command("cjs", "build JS (CommonJS modules)", () => targets.push(import_builder.Target.cjs)).command("graph", "display the workspace graph", () => mode = 3 /* DisplayGraph */).command("tsconfigs", "sync all tsconfigs with package.json", () => mode = 4 /* SyncTsconfigs */).wrap(Math.min(process.stdout.columns, 80)).strict().argv;
+  if (mode === 0 /* BuildProject */) {
+    if (args.workspaces) {
+      mode = 2 /* BuildWorkspace */;
+    } else if (args.dependencies) {
+      mode = 1 /* BuildProjectWithDependencies */;
+    }
+  }
+  function builder(graph) {
+    return new import_builder.Builder({ ...args, targets: [...targets], graph });
+  }
+  switch (mode) {
+    case 0 /* BuildProject */:
+      const project = new import_project.Project(args.prefix);
+      await builder().build(project);
+      break;
+    case 1 /* BuildProjectWithDependencies */:
+      {
+        const graph = await import_graph.Graph.forProject(args.prefix);
+        if (graph === void 0) {
+          throw new Error(`Cannot build with dependencies because ${args.prefix} is not in a workspace`);
+        }
+        await graph.build(builder(graph));
+      }
+      break;
+    case 2 /* BuildWorkspace */:
+      {
+        const graph = await import_graph.Graph.load();
+        await (0, import_tsconfig.syncAllTsconfigs)(graph);
+        await graph.build(builder());
+      }
+      break;
+    case 3 /* DisplayGraph */:
+      (await import_graph.Graph.load()).display();
+      break;
+    case 4 /* SyncTsconfigs */:
+      {
+        const graph = await import_graph.Graph.load();
+        await (0, import_tsconfig.syncAllTsconfigs)(graph);
+      }
+      break;
+  }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cjs/building/cli.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/building/cli.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,mBAAkB;AAClB,qBAAwB;AACxB,qBAAgC;AAChC,mBAAsB;AACtB,qBAAwB;AACxB,sBAAiC;AAXjC;AAAA;AAAA;AAAA;AAAA;AAaA,IAAK,OAAL,kBAAKA,UAAL;AACI,EAAAA,YAAA;AACA,EAAAA,YAAA;AACA,EAAAA,YAAA;AACA,EAAAA,YAAA;AACA,EAAAA,YAAA;AALC,SAAAA;AAAA,GAAA;AAQL,eAAsB,KAAK,OAAO,QAAQ,MAAM;AAC5C,QAAM,UAAU,MAAc;AAC9B,MAAI,OAAO;AAEX,QAAM,OAAO,UAAM,aAAAC,aAAM,wBAAQ,IAAI,CAAC,EACjC,MAAM,kDAAkD,EACxD,OAAO,UAAU,EAAE,OAAO,KAAK,SAAS,KAAK,MAAM,UAAU,UAAU,0BAA0B,CAAC,EAClG,OAAO,SAAS,EAAE,OAAO,KAAK,SAAS,OAAO,MAAM,WAAW,UAAU,qBAAqB,CAAC,EAC/F,OAAO,cAAc,EAAE,OAAO,KAAK,SAAS,OAAO,MAAM,WAAW,UAAU,+BAA+B,CAAC,EAC9G,OAAO,gBAAgB,EAAE,OAAO,KAAK,SAAS,OAAO,MAAM,WAAW,UAAU,qBAAqB,CAAC,EACtG,QAAQ,KAAK,iCAAiC,MAAM;AAAA,EAAC,CAAC,EACtD,QAAQ,SAAS,qCAAqC,MAAM,QAAQ,KAAK,sBAAO,KAAK,CAAC,EACtF,QAAQ,SAAS,0BAA0B,MAAM,QAAQ,KAAK,sBAAO,KAAK,CAAC,EAC3E,QAAQ,OAAO,0BAA0B,MAAM,QAAQ,KAAK,sBAAO,GAAG,CAAC,EACvE,QAAQ,OAAO,+BAA+B,MAAM,QAAQ,KAAK,sBAAO,GAAG,CAAC,EAC5E,QAAQ,SAAS,+BAA+B,MAAO,OAAO,oBAAkB,EAChF,QAAQ,aAAa,wCAAwC,MAAO,OAAO,qBAAmB,EAC9F,KAAK,KAAK,IAAI,QAAQ,OAAO,SAAS,EAAE,CAAC,EACzC,OAAO,EAAE;AAEd,MAAI,SAAS,sBAAmB;AAC5B,QAAI,KAAK,YAAY;AACjB,aAAO;AAAA,IACX,WAAW,KAAK,cAAc;AAC1B,aAAO;AAAA,IACX;AAAA,EACJ;AAEA,WAAS,QAAQ,OAAe;AAC5B,WAAO,IAAI,uBAAQ,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC;AAAA,EAChE;AAEA,UAAQ,MAAc;AAAA,IAClB,KAAK;AACD,YAAM,UAAU,IAAI,uBAAQ,KAAK,MAAM;AACvC,YAAM,QAAQ,EAAE,MAAM,OAAO;AAC7B;AAAA,IAEJ,KAAK;AACD;AACI,cAAM,QAAQ,MAAM,mBAAM,WAAW,KAAK,MAAM;AAChD,YAAI,UAAU,QAAW;AACrB,gBAAM,IAAI,MAAM,0CAA0C,KAAK,MAAM,wBAAwB;AAAA,QACjG;AACA,cAAM,MAAM,MAAM,QAAQ,KAAK,CAAC;AAAA,MACpC;AACA;AAAA,IAEJ,KAAK;AACD;AACI,cAAM,QAAQ,MAAM,mBAAM,KAAK;AAC/B,kBAAM,kCAAiB,KAAK;AAC5B,cAAM,MAAM,MAAM,QAAQ,CAAC;AAAA,MAC/B;AACA;AAAA,IAEJ,KAAK;AACD,OAAC,MAAM,mBAAM,KAAK,GAAG,QAAQ;AAC7B;AAAA,IAEJ,KAAK;AACD;AACI,cAAM,QAAQ,MAAM,mBAAM,KAAK;AAC/B,kBAAM,kCAAiB,KAAK;AAAA,MAChC;AACA;AAAA,EACR;AACJ;",
+  "names": ["Mode", "yargs"]
+}

package/dist/cjs/building/error.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class InternalBuildError extends Error {
+    constructor(message: string);
+}
+export declare class BuildError extends Error {
+    readonly diagnostics: string;
+    constructor(diagnostics: string);
+    get stack(): string;
+    toString(): string;
+    inspect(): string;
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/cjs/building/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/building/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAG9B;AAED,qBAAa,UAAW,SAAQ,KAAK;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAAnB,WAAW,EAAE,MAAM;IAIxC,IAAa,KAAK,WAEjB;IAEQ,QAAQ;IAIjB,OAAO;CAGV"}

package/dist/cjs/building/error.js

@@ -0,0 +1,50 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var error_exports = {};
+__export(error_exports, {
+  BuildError: () => BuildError,
+  InternalBuildError: () => InternalBuildError
+});
+module.exports = __toCommonJS(error_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class InternalBuildError extends Error {
+  constructor(message) {
+    super(message);
+  }
+}
+class BuildError extends Error {
+  constructor(diagnostics) {
+    super();
+    this.diagnostics = diagnostics;
+  }
+  get stack() {
+    return this.diagnostics;
+  }
+  toString() {
+    return this.diagnostics;
+  }
+  inspect() {
+    return this.toString();
+  }
+}
+//# sourceMappingURL=error.js.map

package/dist/cjs/building/error.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/building/error.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,2BAA2B,MAAM;AAAA,EAC1C,YAAY,SAAiB;AACzB,UAAM,OAAO;AAAA,EACjB;AACJ;AAEO,MAAM,mBAAmB,MAAM;AAAA,EAClC,YAAqB,aAAqB;AACtC,UAAM;AADW;AAAA,EAErB;AAAA,EAEA,IAAa,QAAQ;AACjB,WAAO,KAAK;AAAA,EAChB;AAAA,EAES,WAAW;AAChB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,UAAU;AACN,WAAO,KAAK,SAAS;AAAA,EACzB;AACJ;",
+  "names": []
+}

package/dist/cjs/building/graph.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Package } from "../util/package.js";
+import { Builder } from "./builder.js";
+import { BuildInformation, Project } from "./project.js";
+/**
+ * Graph of dependencies for workspace packages.
+ *
+ * We use this information to determine which packages are "dirty" and need rebuild.  In the future we can also use for
+ * parallel build, only tricky part there is showing status.
+ */
+export declare class Graph {
+    #private;
+    readonly nodes: Graph.Node[];
+    protected constructor(nodes: Graph.Node[]);
+    get(name: string): Graph.Node;
+    static load(pkg?: Package): Promise<Graph>;
+    static forProject(path: string): Promise<Graph | undefined>;
+    build(builder: Builder, showSkipped?: boolean): Promise<void>;
+    display(): void;
+}
+export declare namespace Graph {
+    interface Node {
+        pkg: Package;
+        project: Project;
+        dependencies: Node[];
+        buildTime: number;
+        info: BuildInformation;
+        modifyTime: number;
+        isDirty: boolean;
+        prebuildDirty: boolean;
+    }
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/cjs/building/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/building/graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAqB,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAuB,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,KAAK;;IACQ,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;IAAlD,SAAS,aAAsB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;IAElD,GAAG,CAAC,IAAI,EAAE,MAAM;WAQH,IAAI,CAAC,GAAG,UAAoB;WAK5B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAuC3D,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,UAAO;IAmChD,OAAO;CAiHV;AAED,yBAAiB,KAAK,CAAC;IACnB,UAAiB,IAAI;QACjB,GAAG,EAAE,OAAO,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,IAAI,EAAE,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,gBAAgB,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;KAC1B;CACJ"}

package/dist/cjs/building/graph.js

@@ -0,0 +1,222 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var graph_exports = {};
+__export(graph_exports, {
+  Graph: () => Graph
+});
+module.exports = __toCommonJS(graph_exports);
+var import_map_workspaces = __toESM(require("@npmcli/map-workspaces"), 1);
+var import_ansi_colors = __toESM(require("ansi-colors"), 1);
+var import_package = require("../util/package.js");
+var import_progress = require("../util/progress.js");
+var import_error = require("./error.js");
+var import_project = require("./project.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class Graph {
+  constructor(nodes) {
+    this.nodes = nodes;
+  }
+  get(name) {
+    const node = this.nodes.find((node2) => node2.pkg.name === name);
+    if (node === void 0) {
+      throw new Error(`Cannot locate package "${name}"`);
+    }
+    return node;
+  }
+  static async load(pkg = import_package.Package.workspace) {
+    const nodeMap = await this.#loadNodes(pkg.workspace);
+    return await this.#createGraph(Object.values(nodeMap));
+  }
+  static async forProject(path) {
+    let workspace;
+    try {
+      workspace = import_package.Package.workspaceFor(path);
+    } catch (e) {
+      if (e instanceof import_package.JsonNotFoundError) {
+        return;
+      }
+      throw e;
+    }
+    const nodeMap = await this.#loadNodes(workspace);
+    const rootPkg = new import_package.Package({ path });
+    const rootNode = nodeMap[rootPkg.json.name];
+    if (!rootNode) {
+      return;
+    }
+    const nodes = /* @__PURE__ */ new Set();
+    function addNode(node) {
+      if (nodes.has(node)) {
+        return;
+      }
+      nodes.add(node);
+      for (const dependency of node.dependencies) {
+        addNode(dependency);
+      }
+    }
+    addNode(rootNode);
+    return await this.#createGraph([...nodes]);
+  }
+  // TODO - parallelization will be trivial except need to update Progress
+  // to support display of multiple simultaneous tasks
+  async build(builder, showSkipped = true) {
+    const toBuild = new Set(this.nodes);
+    for (const node of this.nodes) {
+      await builder.configure(node.project);
+    }
+    while (toBuild.size) {
+      let node;
+      nodes: for (node of toBuild) {
+        for (const dep of node.dependencies) {
+          if (dep.isDirty) {
+            continue nodes;
+          }
+        }
+        break;
+      }
+      if (!node) {
+        throw new Error("Internal logic error: No unbuilt project has fully built dependencies");
+      }
+      if (node.isDirty || builder.unconditional) {
+        await builder.build(node.project);
+        node.info.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+      } else if (showSkipped) {
+        new import_progress.Progress().skip("Up to date", node.pkg);
+      }
+      toBuild.delete(node);
+    }
+  }
+  display() {
+    for (const node of this.nodes) {
+      const progress = node.pkg.start("Node");
+      progress.info("path", node.pkg.path);
+      progress.info("modified", formatTime(node.modifyTime));
+      progress.info("built", formatTime(node.info.timestamp ?? 0));
+      progress.info("dirty", node.isDirty ? import_ansi_colors.default.dim.red("yes") : import_ansi_colors.default.dim.green("no"));
+      progress.info("dependencies", node.dependencies.map(formatDep).join(", "));
+      progress.shutdown();
+    }
+  }
+  static async #createGraph(nodes) {
+    const graph = new Graph(nodes);
+    await Promise.all(
+      graph.nodes.map(async (node) => {
+        if (node.pkg.hasFile(import_project.BUILD_INFO_LOCATION)) {
+          node.info = await node.pkg.readJson(import_project.BUILD_INFO_LOCATION);
+        }
+        node.modifyTime = await node.pkg.lastModified("package.json", "src", "test");
+        return node;
+      })
+    );
+    const stack = Array();
+    function findCircular(node) {
+      if (stack.indexOf(node) !== -1) {
+        stack.push(node);
+        throw new import_error.InternalBuildError(`Circular dependency: ${stack.map(formatDep).join(" \u25B8 ")}`);
+      }
+      stack.push(node);
+      for (const dep of node.dependencies) {
+        findCircular(dep);
+      }
+      stack.pop();
+    }
+    for (const node of graph.nodes) {
+      findCircular(node);
+    }
+    return graph;
+  }
+  static async #loadNodes(workspace) {
+    const workspaces = await (0, import_map_workspaces.default)({ pkg: workspace.json, cwd: workspace.path });
+    const nodeMap = {};
+    const allDeps = {};
+    for (const path of workspaces.values()) {
+      const pkg = new import_package.Package({ path });
+      allDeps[pkg.json.name] = pkg.dependencies;
+      nodeMap[pkg.json.name] = {
+        pkg,
+        project: new import_project.Project(pkg),
+        dependencies: [],
+        info: {},
+        modifyTime: 0,
+        get buildTime() {
+          return this.info.timestamp ? new Date(this.info.timestamp).getTime() : 0;
+        },
+        get isDirty() {
+          return this.modifyTime > this.buildTime || !!this.dependencies.find(
+            (dep) => dep.isDirty || dep.buildTime > this.buildTime && (dep.info.apiSha === void 0 || dep.info.apiSha !== this.info.dependencyApiShas?.[dep.pkg.name])
+          );
+        },
+        // This version of dirty should only be used after building all dependencies.  If this project is
+        // unmodified and the SHA of the type definitions of the target project is also unmodified then we do
+        // not need to build
+        get prebuildDirty() {
+          if (this.modifyTime > this.buildTime) {
+            return true;
+          }
+          const depShas = this.info.dependencyApiShas;
+          if (typeof depShas !== "object") {
+            return this.isDirty;
+          }
+          for (const dep of this.dependencies) {
+            const depSha = depShas[dep.pkg.name];
+            if (depSha === void 0 || depSha !== dep.info.apiSha) {
+              return true;
+            }
+          }
+          return false;
+        }
+      };
+    }
+    for (const name in allDeps) {
+      for (const dep of allDeps[name]) {
+        const depNode = nodeMap[dep];
+        if (depNode && depNode !== nodeMap[name]) {
+          nodeMap[name].dependencies.push(depNode);
+        }
+      }
+    }
+    return nodeMap;
+  }
+}
+function formatTime(time) {
+  if (!time) {
+    return import_ansi_colors.default.dim.red("never");
+  }
+  if (typeof time === "string") {
+    time = new Date(time).getTime();
+  }
+  return new Date(time - (/* @__PURE__ */ new Date()).getTimezoneOffset()).toISOString().split(".")[0].replace("T", " ");
+}
+function formatDep(node) {
+  return node.pkg.name.replace(/^@(?:project-chip|matter\.js)\//, "");
+}
+//# sourceMappingURL=graph.js.map

package/dist/cjs/building/graph.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/building/graph.ts"],
+  "mappings": "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",
+  "names": ["node", "colors", "mapWorkspaces"]
+}

package/dist/cjs/building/project.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Hash } from "crypto";
+import { Format } from "esbuild";
+import { Package } from "../util/package.js";
+import { Progress } from "../util/progress.js";
+export declare const BUILD_INFO_LOCATION = "build/info.json";
+export interface BuildInformation {
+    /**
+     * Time of last build.  Compared to source files to determine whether build is dirty.
+     */
+    timestamp?: string;
+    /**
+     * API signature.  Used by dependents to determine whether they need to rebuild after we do.
+     */
+    apiSha?: string;
+    /**
+     * API signature of each dependency.  Compared to apiSha of each dependency during dirty detection.
+     */
+    dependencyApiShas?: Record<string, string>;
+}
+export declare class Project {
+    #private;
+    pkg: Package;
+    constructor(source?: Package | string);
+    buildSource(format: Format): Promise<void>;
+    buildTests(format: Format): Promise<void>;
+    clean(): Promise<void>;
+    /**
+     * Installs declaration files into specified directory.  Also computes SHA-1 hash for all files that we use to
+     * detect "public API changes".
+     *
+     * Note we use cp to traverse filesystem, detect changes, locate source maps and compute API SHA.  A little
+     * convoluted but works.  When you correct for a node 20/windows bug.
+     */
+    installDeclarationFormats(formats: Iterable<string>, apiSha?: Hash): Promise<void>;
+    get hasDeclarations(): boolean;
+    installDeclarations(apiSha?: Hash): Promise<void>;
+    recordBuildInfo(info: BuildInformation): Promise<void>;
+    configure(progress: Progress): Promise<Project.Config | undefined>;
+}
+export declare namespace Project {
+    interface Context {
+        project: Project;
+        progress: Progress;
+    }
+    interface Config {
+        startup?: (context: Context) => Promise<void>;
+        before?: (context: Context) => Promise<void>;
+        after?: (context: Context) => Promise<void>;
+    }
+}
+//# sourceMappingURL=project.d.ts.map

package/dist/cjs/building/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/building/project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAoB,MAAM,EAAE,MAAM,SAAS,CAAC;AAMnD,OAAO,EAAe,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,qBAAa,OAAO;;IAChB,GAAG,EAAE,OAAO,CAAC;gBAID,MAAM,GAAE,OAAO,GAAG,MAAY;IAYpC,WAAW,CAAC,MAAM,EAAE,MAAM;IAK1B,UAAU,CAAC,MAAM,EAAE,MAAM;IA2BzB,KAAK;IAMX;;;;;;OAMG;IACG,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI;IAsFxE,IAAI,eAAe,YAElB;IAEK,mBAAmB,CAAC,MAAM,CAAC,EAAE,IAAI;IAYjC,eAAe,CAAC,IAAI,EAAE,gBAAgB;IAMtC,SAAS,CAAC,QAAQ,EAAE,QAAQ;CA8FrC;AAED,yBAAiB,OAAO,CAAC;IACrB,UAAiB,OAAO;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,QAAQ,CAAC;KACtB;IAED,UAAiB,MAAM;QACnB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/C;CACJ"}