@camstack/addon-pipeline 1.1.0 → 1.1.2

package/dist/audio-analyzer/index.js

@@ -2,12 +2,12 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_model_download_service_RxAOiYvX = require("../model-download-service-RxAOiYvX-C8rTRJy_.js");
-const require_dist = require("../dist-BLcTVvol.js");
+const require_model_download_service_C_IHWnXx = require("../model-download-service-C-IHWnXx-BnQ_awK4.js");
+const require_dist = require("../dist-DnD2tm7T.js");
 let node_fs = require("node:fs");
-node_fs = require_model_download_service_RxAOiYvX.__toESM(node_fs);
+node_fs = require_model_download_service_C_IHWnXx.__toESM(node_fs);
 let node_path = require("node:path");
-node_path = require_model_download_service_RxAOiYvX.__toESM(node_path);
+node_path = require_model_download_service_C_IHWnXx.__toESM(node_path);
 //#region src/audio-analyzer/audio-pipeline.ts
 /**
 * Create the appropriate audio pipeline.
@@ -82,7 +82,7 @@ var YamnetPythonPipeline = class {
 				url: YAMNET_MODEL_URL,
 				dest: modelPath
 			} });
-			await require_model_download_service_RxAOiYvX.downloadFile(YAMNET_MODEL_URL, modelPath);
+			await require_model_download_service_C_IHWnXx.downloadFile(YAMNET_MODEL_URL, modelPath);
 			this.log.info("YAMNet ONNX model downloaded", { meta: { sizeBytes: node_fs.statSync(modelPath).size } });
 		}
 		if (!node_fs.existsSync(labelsPath)) {
@@ -90,7 +90,7 @@ var YamnetPythonPipeline = class {
 				url: YAMNET_LABELS_URL,
 				dest: labelsPath
 			} });
-			await require_model_download_service_RxAOiYvX.downloadFile(YAMNET_LABELS_URL, labelsPath);
+			await require_model_download_service_C_IHWnXx.downloadFile(YAMNET_LABELS_URL, labelsPath);
 		}
 		const pythonDir = resolveAudioPythonDir();
 		if (this.installPythonRequirements) await this.installPythonRequirements(node_path.join(pythonDir, "requirements-audio.txt"));
@@ -623,6 +623,20 @@ var AudioAnalyzerProvider = class {
 	async dispose() {
 		await this.pipeline.dispose();
 	}
+	/**
+	* Swap the live pipeline in place (optimistic backend/model change) — disposes
+	* the old pipeline AFTER the new one is wired in, so an in-flight classify
+	* never sees a null pipeline. Lets the audio engine settings apply without an
+	* addon restart, mirroring the detection-pipeline's in-place engine swap.
+	*/
+	async swapPipeline(next, nextBackend) {
+		const prev = this.pipeline;
+		this.pipeline = next;
+		this.backendName = nextBackend;
+		if (prev && prev !== next) try {
+			await prev.dispose();
+		} catch {}
+	}
 	async reprobeAudioEngine() {
 		return this.reprobeImpl();
 	}
@@ -637,6 +651,9 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	id = "audio-analyzer";
 	provider = null;
 	pipeline = null;
+	/** Backend the live `pipeline` actually runs — drives the optimistic in-place
+	*  rebuild in `onConfigChanged` (rebuild only when it genuinely flips). */
+	activeBackend = null;
 	constructor() {
 		super(require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG);
 	}
@@ -670,8 +687,7 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 						label: o.label
 					})),
 					default: require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				},
 				{
 					type: "select",
@@ -683,8 +699,7 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 						label: o.label
 					})),
 					default: require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG.selectedAudioModel,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				}
 			]
 		}] };
@@ -704,20 +719,24 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	*  preview mode (operator typed but didn't save yet) — same
 	*  semantics detection-pipeline relies on.
 	*/
-	async getGlobalSettings(overlay) {
+	async getGlobalSettings(overlay, nodeId) {
 		const ctx = this.ctxIfReady;
 		const stored = ctx?.settings ? await ctx.settings.readAddonStore() ?? {} : {};
 		const merged = overlay ? {
 			...stored,
 			...overlay
 		} : stored;
-		const operatorChoice = typeof merged.audioBackend === "string" ? merged.audioBackend : require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend;
-		const effectiveBackend = operatorChoice === "apple-soundanalysis" ? "apple-soundanalysis" : operatorChoice === "yamnet-onnx" ? "yamnet-onnx" : process.platform === "darwin" ? "apple-soundanalysis" : "yamnet-onnx";
-		const filteredModels = AUDIO_MODEL_OPTIONS.filter((o) => o.value === "" || o.value === effectiveBackend);
+		const isDarwin = await this.probeNodePlatform(nodeId) === "darwin";
+		const backendOptions = require_dist.AUDIO_BACKEND_CHOICES.filter((o) => o.value !== "apple-soundanalysis" || isDarwin);
+		const operatorChoiceRaw = typeof merged.audioBackend === "string" ? merged.audioBackend : require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend;
+		const operatorChoice = backendOptions.some((o) => o.value === operatorChoiceRaw) ? operatorChoiceRaw : require_dist.DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend;
+		const effectiveBackend = operatorChoice === "apple-soundanalysis" ? "apple-soundanalysis" : operatorChoice === "yamnet-onnx" ? "yamnet-onnx" : isDarwin ? "apple-soundanalysis" : "yamnet-onnx";
+		const filteredModels = AUDIO_MODEL_OPTIONS.filter((o) => (o.value === "" || o.value === effectiveBackend) && (o.value !== "apple-soundanalysis" || isDarwin));
 		const storedModel = typeof merged.selectedAudioModel === "string" ? merged.selectedAudioModel : "";
 		const validModel = filteredModels.find((o) => o.value === storedModel)?.value ?? "";
 		const raw = {
 			...merged,
+			audioBackend: operatorChoice,
 			selectedAudioModel: validModel
 		};
 		const schema = this.globalSettingsSchema();
@@ -726,6 +745,13 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 			sections: schema.sections.map((section) => ({
 				...section,
 				fields: section.fields.map((field) => {
+					if (field.type === "select" && field.key === "audioBackend") return {
+						...field,
+						options: backendOptions.map((o) => ({
+							value: o.value,
+							label: o.label
+						}))
+					};
 					if (field.type === "select" && field.key === "selectedAudioModel") return {
 						...field,
 						options: filteredModels.map((o) => ({
@@ -739,6 +765,23 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 		}, raw);
 	}
 	/**
+	* Probe the OS platform of `nodeId` (default: this node) via the
+	* `platform-probe` cap — the same source the detection-pipeline uses to gate
+	* accelerator backends. Falls back to this host's `process.platform` when the
+	* probe is unreachable (cold-start / probe addon absent), so the form stays
+	* usable rather than collapsing.
+	*/
+	async probeNodePlatform(nodeId) {
+		const api = this.ctxIfReady?.api;
+		if (!api) return process.platform;
+		const localNode = this.ctxIfReady?.kernel?.localNodeId;
+		try {
+			return (nodeId && nodeId !== localNode ? await api.platformProbe.getCapabilities.query(void 0, require_dist.nodePin(nodeId)) : await api.platformProbe.getCapabilities.query())?.platform ?? process.platform;
+		} catch {
+			return process.platform;
+		}
+	}
+	/**
 	* Re-run the platform probe and persist the detected backend into
 	* `probedBestAudioBackend`. Operator `audioBackend` setting is not
 	* touched — only the hint.
@@ -758,23 +801,10 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 	}
 	async onInitialize() {
 		const logger = this.ctx.logger;
-		const modelsDir = await this.ctx.api.storage.resolve.query({
-			location: "models",
-			relativePath: ""
-		}).catch(() => "camstack-data/models");
 		const backend = this.resolveAudioBackend();
-		logger.info("audio-analyzer: resolving pipeline", { meta: {
-			operatorChoice: this.config.audioBackend,
-			effectiveBackend: backend,
-			selectedModel: this.config.selectedAudioModel || null
-		} });
-		const p = await createAudioPipeline(modelsDir, logger, {
-			backend,
-			pythonPath: backend === "yamnet-onnx" ? await this.ctx.deps.ensurePython() ?? void 0 : void 0,
-			installPythonRequirements: (f) => this.ctx.deps.installPythonRequirements(f)
-		});
-		await p.initialize();
+		const p = await this.buildPipeline(backend);
 		this.pipeline = p;
+		this.activeBackend = backend;
 		if (!this.config.probedBestAudioBackend) this.reprobeAudioEngine().catch((err) => {
 			logger.warn("audio: auto-reprobe failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
@@ -812,6 +842,51 @@ var AudioAnalyzerAddon = class extends require_dist.BaseAddon {
 			this.provider = null;
 		}
 		this.pipeline = null;
+		this.activeBackend = null;
+	}
+	/**
+	* Build + initialize an audio pipeline for `backend`. YAMNet runs in the
+	* embedded portable Python (resolve interpreter + lazily install reqs); Apple
+	* SoundAnalysis needs neither. Shared by `onInitialize` (first boot) and
+	* `onConfigChanged` (in-place rebuild).
+	*/
+	async buildPipeline(backend) {
+		const logger = this.ctx.logger;
+		const modelsDir = await this.ctx.api.storage.resolve.query({
+			location: "models",
+			relativePath: ""
+		}).catch(() => "camstack-data/models");
+		logger.info("audio-analyzer: resolving pipeline", { meta: {
+			operatorChoice: this.config.audioBackend,
+			effectiveBackend: backend,
+			selectedModel: this.config.selectedAudioModel || null
+		} });
+		const p = await createAudioPipeline(modelsDir, logger, {
+			backend,
+			pythonPath: backend === "yamnet-onnx" ? await this.ctx.deps.ensurePython() ?? void 0 : void 0,
+			installPythonRequirements: (f) => this.ctx.deps.installPythonRequirements(f)
+		});
+		await p.initialize();
+		return p;
+	}
+	/**
+	* Optimistic settings apply — rebuild the pipeline IN PLACE when the effective
+	* audio backend changes, instead of bouncing the whole addon. The audio engine
+	* fields therefore drop `requiresRestart`: BaseAddon calls this after every
+	* global-settings write; we rebuild only when the backend genuinely flips.
+	*/
+	async onConfigChanged() {
+		if (!this.provider) return;
+		const backend = this.resolveAudioBackend();
+		if (backend === this.activeBackend) return;
+		this.ctx.logger.info("audio backend changed — rebuilding pipeline in place", { meta: {
+			from: this.activeBackend,
+			to: backend
+		} });
+		const next = await this.buildPipeline(backend);
+		await this.provider.swapPipeline(next, backend);
+		this.pipeline = next;
+		this.activeBackend = backend;
 	}
 	buildDeviceSchema() {
 		return { sections: [] };

package/dist/audio-analyzer/index.mjs

@@ -1,6 +1,6 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { B as BaseAddon, E as mapAudioLabelToMacro, J as hydrateSchema, g as audioAnalyzerCapability, h as audioAnalysisCapability, l as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, z as errMsg } from "../dist-BA6DR_jV.mjs";
-import { r as downloadFile } from "../model-download-service-RxAOiYvX-CMAvhgO7.mjs";
+import { A as nodePin, B as BaseAddon, E as mapAudioLabelToMacro, J as hydrateSchema, g as audioAnalyzerCapability, h as audioAnalysisCapability, l as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, z as errMsg } from "../dist-BWc-HYQz.mjs";
+import { r as downloadFile } from "../model-download-service-C-IHWnXx-3Mmeob3l.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 //#region src/audio-analyzer/audio-pipeline.ts
@@ -618,6 +618,20 @@ var AudioAnalyzerProvider = class {
 	async dispose() {
 		await this.pipeline.dispose();
 	}
+	/**
+	* Swap the live pipeline in place (optimistic backend/model change) — disposes
+	* the old pipeline AFTER the new one is wired in, so an in-flight classify
+	* never sees a null pipeline. Lets the audio engine settings apply without an
+	* addon restart, mirroring the detection-pipeline's in-place engine swap.
+	*/
+	async swapPipeline(next, nextBackend) {
+		const prev = this.pipeline;
+		this.pipeline = next;
+		this.backendName = nextBackend;
+		if (prev && prev !== next) try {
+			await prev.dispose();
+		} catch {}
+	}
 	async reprobeAudioEngine() {
 		return this.reprobeImpl();
 	}
@@ -632,6 +646,9 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 	id = "audio-analyzer";
 	provider = null;
 	pipeline = null;
+	/** Backend the live `pipeline` actually runs — drives the optimistic in-place
+	*  rebuild in `onConfigChanged` (rebuild only when it genuinely flips). */
+	activeBackend = null;
 	constructor() {
 		super(DEFAULT_AUDIO_ANALYZER_CONFIG);
 	}
@@ -665,8 +682,7 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 						label: o.label
 					})),
 					default: DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				},
 				{
 					type: "select",
@@ -678,8 +694,7 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 						label: o.label
 					})),
 					default: DEFAULT_AUDIO_ANALYZER_CONFIG.selectedAudioModel,
-					immediate: true,
-					requiresRestart: true
+					immediate: true
 				}
 			]
 		}] };
@@ -699,20 +714,24 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 	*  preview mode (operator typed but didn't save yet) — same
 	*  semantics detection-pipeline relies on.
 	*/
-	async getGlobalSettings(overlay) {
+	async getGlobalSettings(overlay, nodeId) {
 		const ctx = this.ctxIfReady;
 		const stored = ctx?.settings ? await ctx.settings.readAddonStore() ?? {} : {};
 		const merged = overlay ? {
 			...stored,
 			...overlay
 		} : stored;
-		const operatorChoice = typeof merged.audioBackend === "string" ? merged.audioBackend : DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend;
-		const effectiveBackend = operatorChoice === "apple-soundanalysis" ? "apple-soundanalysis" : operatorChoice === "yamnet-onnx" ? "yamnet-onnx" : process.platform === "darwin" ? "apple-soundanalysis" : "yamnet-onnx";
-		const filteredModels = AUDIO_MODEL_OPTIONS.filter((o) => o.value === "" || o.value === effectiveBackend);
+		const isDarwin = await this.probeNodePlatform(nodeId) === "darwin";
+		const backendOptions = AUDIO_BACKEND_CHOICES.filter((o) => o.value !== "apple-soundanalysis" || isDarwin);
+		const operatorChoiceRaw = typeof merged.audioBackend === "string" ? merged.audioBackend : DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend;
+		const operatorChoice = backendOptions.some((o) => o.value === operatorChoiceRaw) ? operatorChoiceRaw : DEFAULT_AUDIO_ANALYZER_CONFIG.audioBackend;
+		const effectiveBackend = operatorChoice === "apple-soundanalysis" ? "apple-soundanalysis" : operatorChoice === "yamnet-onnx" ? "yamnet-onnx" : isDarwin ? "apple-soundanalysis" : "yamnet-onnx";
+		const filteredModels = AUDIO_MODEL_OPTIONS.filter((o) => (o.value === "" || o.value === effectiveBackend) && (o.value !== "apple-soundanalysis" || isDarwin));
 		const storedModel = typeof merged.selectedAudioModel === "string" ? merged.selectedAudioModel : "";
 		const validModel = filteredModels.find((o) => o.value === storedModel)?.value ?? "";
 		const raw = {
 			...merged,
+			audioBackend: operatorChoice,
 			selectedAudioModel: validModel
 		};
 		const schema = this.globalSettingsSchema();
@@ -721,6 +740,13 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 			sections: schema.sections.map((section) => ({
 				...section,
 				fields: section.fields.map((field) => {
+					if (field.type === "select" && field.key === "audioBackend") return {
+						...field,
+						options: backendOptions.map((o) => ({
+							value: o.value,
+							label: o.label
+						}))
+					};
 					if (field.type === "select" && field.key === "selectedAudioModel") return {
 						...field,
 						options: filteredModels.map((o) => ({
@@ -734,6 +760,23 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 		}, raw);
 	}
 	/**
+	* Probe the OS platform of `nodeId` (default: this node) via the
+	* `platform-probe` cap — the same source the detection-pipeline uses to gate
+	* accelerator backends. Falls back to this host's `process.platform` when the
+	* probe is unreachable (cold-start / probe addon absent), so the form stays
+	* usable rather than collapsing.
+	*/
+	async probeNodePlatform(nodeId) {
+		const api = this.ctxIfReady?.api;
+		if (!api) return process.platform;
+		const localNode = this.ctxIfReady?.kernel?.localNodeId;
+		try {
+			return (nodeId && nodeId !== localNode ? await api.platformProbe.getCapabilities.query(void 0, nodePin(nodeId)) : await api.platformProbe.getCapabilities.query())?.platform ?? process.platform;
+		} catch {
+			return process.platform;
+		}
+	}
+	/**
 	* Re-run the platform probe and persist the detected backend into
 	* `probedBestAudioBackend`. Operator `audioBackend` setting is not
 	* touched — only the hint.
@@ -753,23 +796,10 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 	}
 	async onInitialize() {
 		const logger = this.ctx.logger;
-		const modelsDir = await this.ctx.api.storage.resolve.query({
-			location: "models",
-			relativePath: ""
-		}).catch(() => "camstack-data/models");
 		const backend = this.resolveAudioBackend();
-		logger.info("audio-analyzer: resolving pipeline", { meta: {
-			operatorChoice: this.config.audioBackend,
-			effectiveBackend: backend,
-			selectedModel: this.config.selectedAudioModel || null
-		} });
-		const p = await createAudioPipeline(modelsDir, logger, {
-			backend,
-			pythonPath: backend === "yamnet-onnx" ? await this.ctx.deps.ensurePython() ?? void 0 : void 0,
-			installPythonRequirements: (f) => this.ctx.deps.installPythonRequirements(f)
-		});
-		await p.initialize();
+		const p = await this.buildPipeline(backend);
 		this.pipeline = p;
+		this.activeBackend = backend;
 		if (!this.config.probedBestAudioBackend) this.reprobeAudioEngine().catch((err) => {
 			logger.warn("audio: auto-reprobe failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
@@ -807,6 +837,51 @@ var AudioAnalyzerAddon = class extends BaseAddon {
 			this.provider = null;
 		}
 		this.pipeline = null;
+		this.activeBackend = null;
+	}
+	/**
+	* Build + initialize an audio pipeline for `backend`. YAMNet runs in the
+	* embedded portable Python (resolve interpreter + lazily install reqs); Apple
+	* SoundAnalysis needs neither. Shared by `onInitialize` (first boot) and
+	* `onConfigChanged` (in-place rebuild).
+	*/
+	async buildPipeline(backend) {
+		const logger = this.ctx.logger;
+		const modelsDir = await this.ctx.api.storage.resolve.query({
+			location: "models",
+			relativePath: ""
+		}).catch(() => "camstack-data/models");
+		logger.info("audio-analyzer: resolving pipeline", { meta: {
+			operatorChoice: this.config.audioBackend,
+			effectiveBackend: backend,
+			selectedModel: this.config.selectedAudioModel || null
+		} });
+		const p = await createAudioPipeline(modelsDir, logger, {
+			backend,
+			pythonPath: backend === "yamnet-onnx" ? await this.ctx.deps.ensurePython() ?? void 0 : void 0,
+			installPythonRequirements: (f) => this.ctx.deps.installPythonRequirements(f)
+		});
+		await p.initialize();
+		return p;
+	}
+	/**
+	* Optimistic settings apply — rebuild the pipeline IN PLACE when the effective
+	* audio backend changes, instead of bouncing the whole addon. The audio engine
+	* fields therefore drop `requiresRestart`: BaseAddon calls this after every
+	* global-settings write; we rebuild only when the backend genuinely flips.
+	*/
+	async onConfigChanged() {
+		if (!this.provider) return;
+		const backend = this.resolveAudioBackend();
+		if (backend === this.activeBackend) return;
+		this.ctx.logger.info("audio backend changed — rebuilding pipeline in place", { meta: {
+			from: this.activeBackend,
+			to: backend
+		} });
+		const next = await this.buildPipeline(backend);
+		await this.provider.swapPipeline(next, backend);
+		this.pipeline = next;
+		this.activeBackend = backend;
 	}
 	buildDeviceSchema() {
 		return { sections: [] };

package/dist/audio-codec-nodeav/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BLcTVvol.js");
+const require_dist = require("../dist-DnD2tm7T.js");
 const require_codec_runtime = require("../codec-runtime-BOk-13PN.js");
 let node_crypto = require("node:crypto");
 //#region src/audio-codec-nodeav/addon/index.ts

package/dist/audio-codec-nodeav/index.mjs

@@ -1,4 +1,4 @@
-import { B as BaseAddon, _ as audioCodecCapability, z as errMsg } from "../dist-BA6DR_jV.mjs";
+import { B as BaseAddon, _ as audioCodecCapability, z as errMsg } from "../dist-BWc-HYQz.mjs";
 import { t as DecodeRuntime } from "../codec-runtime-BsqlEjPi.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/audio-codec-nodeav/addon/index.ts

package/dist/decoder-nodeav/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BLcTVvol.js");
+const require_dist = require("../dist-DnD2tm7T.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 let node_crypto = require("node:crypto");
 //#region src/decoder-nodeav/frame-ring-sink.ts

package/dist/decoder-nodeav/index.mjs

@@ -1,4 +1,4 @@
-import { B as BaseAddon, b as decoderCapability, f as RingBuffer, s as DEFAULT_DECODER_HWACCEL_CONFIG, u as HWACCEL_OPTIONS, z as errMsg } from "../dist-BA6DR_jV.mjs";
+import { B as BaseAddon, b as decoderCapability, f as RingBuffer, s as DEFAULT_DECODER_HWACCEL_CONFIG, u as HWACCEL_OPTIONS, z as errMsg } from "../dist-BWc-HYQz.mjs";
 import { FrameRingReaderCache, FrameRingWriter, MIN_RING_SLOTS, computeSegmentSize, computeSlotByteLength, createSegment, deriveSlotCount } from "@camstack/shm-ring";
 import { randomUUID } from "node:crypto";
 //#region src/decoder-nodeav/frame-ring-sink.ts