Build the Apple Container extension

Turns the empty scaffold into a working Nova extension for Apple Container and container-compose, in the shape of the Docker Suite extension. Sidebar (Scripts/Sidebar): - System, Containers, Images, Volumes and Networks sections - Containers grouped into compose projects via the com.docker.compose.project label container-compose stamps; project rows drive compose up/down/build against the matching workspace file - Lifecycle, shell, logs, inspect, browse and copy commands per resource - Apple Container publishes no event stream, so the sidebar polls while visible and only reloads a section when a fingerprint of its data changes, which keeps selection and expansion intact Hostnames (Scripts/Hostnames.js): - A container's hostname is <name>.<domain> and the domain lives in Apple Container's config.toml, which has no CLI setter, so the Hostname Domain preference reads and writes that file directly - Changing it offers to register the domain with macOS and restart the services; the write preserves the file's other tables and its mode Language support: - Dockerfile and Compose syntaxes backed by tree-sitter grammars built by Tools/build-syntaxes.sh, pinned to revisions that generate ABI 14 - The Compose syntax is named dockercompose because that is the languageId docker-language-server recognises compose files by - docker-language-server is downloaded on first use rather than bundled, at roughly 40 MB Icons are generated by Tools/make-icons.py so they can be regenerated rather than hand-maintained. Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_01UnSBcR5Lywz5Fbj5FmVbfc
2026-08-18 22:45:14 -03:00
parent 0879e5a163
commit 0506f44db3
80 changed files with 5201 additions and 3 deletions
@@ -0,0 +1,166 @@
+//
+// Owns the sidebar's controllers and the polling that keeps them current.
+//
+// Apple Container publishes no event stream, so the sidebar polls on an
+// interval while it is visible. Controllers only reload their tree when the
+// data actually changed, which keeps selection and expansion intact.
+//
+
+const { SystemController } = require("./TreeViews/System");
+const { ContainersController } = require("./TreeViews/Containers");
+const { ImagesController } = require("./TreeViews/Images");
+const { VolumesController } = require("./TreeViews/Volumes");
+const { NetworksController } = require("./TreeViews/Networks");
+const { ContainerCLI } = require("../Interfaces/ContainerCLI");
+const notify = require("../Utilities/Notify");
+
+class ContainerSidebar {
+	constructor() {
+		this.controllers = null;
+		this.timer = null;
+		this.refreshing = false;
+		this.watchers = new CompositeDisposable();
+
+		this.watchers.add(
+			nova.config.onDidChange("apple_container.sidebar.disabled", () => this.restart())
+		);
+		this.watchers.add(
+			nova.config.onDidChange("apple_container.sidebar.refresh", () => this.schedule())
+		);
+
+		this.start();
+	}
+
+	start() {
+		if (nova.config.get("apple_container.sidebar.disabled", "boolean")) {
+			return;
+		}
+
+		this.system = new SystemController(this);
+		this.containers = new ContainersController(this);
+		this.images = new ImagesController(this);
+		this.volumes = new VolumesController(this);
+		this.networks = new NetworksController(this);
+
+		this.controllers = [this.system, this.containers, this.images, this.volumes, this.networks];
+
+		this.bootstrap();
+		this.schedule();
+	}
+
+	stop() {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = null;
+		}
+
+		if (this.controllers) {
+			for (let controller of this.controllers) {
+				controller.dispose();
+			}
+			this.controllers = null;
+		}
+	}
+
+	dispose() {
+		this.stop();
+		this.watchers.dispose();
+	}
+
+	restart() {
+		this.stop();
+		this.start();
+	}
+
+	// First pass: start the services when asked to, then fill every section.
+	async bootstrap() {
+		if (nova.config.get("apple_container.sidebar.autostart", "boolean")) {
+			let status = await ContainerCLI.systemStatus();
+
+			if (status.status !== "running") {
+				try {
+					await ContainerCLI.systemStart();
+				} catch (error) {
+					notify.configFailure(
+						"Unable to start container services",
+						error,
+						"apple-container-autostart"
+					);
+				}
+			}
+		}
+
+		return this.refresh({ force: true });
+	}
+
+	schedule() {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = null;
+		}
+
+		if (!this.controllers) {
+			return;
+		}
+
+		let seconds = nova.config.get("apple_container.sidebar.refresh", "number");
+
+		if (typeof seconds !== "number" || seconds <= 0) {
+			return;
+		}
+
+		this.timer = setInterval(() => this.refresh(), Math.max(1, seconds) * 1000);
+	}
+
+	// One refresh at a time, and only for sections the user can actually see.
+	async refresh(options = {}) {
+		if (!this.controllers || this.refreshing) {
+			return;
+		}
+
+		this.refreshing = true;
+
+		try {
+			await this.system.refresh(options);
+
+			if (!this.system.running) {
+				for (let controller of this.sections()) {
+					controller.clear();
+				}
+				return;
+			}
+
+			let pending = this.sections()
+				.filter((controller) => options.force || controller.visible)
+				.map((controller) => controller.refresh(options));
+
+			await Promise.all(pending);
+		} finally {
+			this.refreshing = false;
+		}
+	}
+
+	sections() {
+		return [this.containers, this.images, this.volumes, this.networks];
+	}
+
+	reload() {
+		if (!this.controllers) {
+			return Promise.resolve();
+		}
+
+		for (let controller of this.controllers) {
+			controller.invalidate();
+		}
+
+		return this.refresh({ force: true });
+	}
+
+	reloadContainers() {
+		if (this.containers) {
+			this.containers.reload();
+		}
+	}
+}
+
+module.exports = { ContainerSidebar };