@camstack/system 1.2.390 → 1.2.391

package/dist/kernel/deps/ensure-native-prebuilds.d.ts

@@ -1,40 +1,40 @@
-import { IScopedLogger } from '@camstack/types';
+import type { IScopedLogger } from "@camstack/types";
 /** Bounded recursive `.node` scan depth inside a module dir. */
 export declare const NATIVE_SCAN_DEPTH = 4;
 /**
- * Traditional (compile-or-prebuild) natives an installed closure must carry a
- * `.node` for. Only these are ENSURE-able by a prebuild re-fetch; N-API natives
- * are excluded (see file header).
- */
+* Traditional (compile-or-prebuild) natives an installed closure must carry a
+* `.node` for. Only these are ENSURE-able by a prebuild re-fetch; N-API natives
+* are excluded (see file header).
+*/
 export declare const TRADITIONAL_NATIVE_PACKAGES: readonly string[];
 /** The running Node ABI/arch the fetched prebuild must match. */
 export interface PrebuildTarget {
-    /** Node version, e.g. `process.versions.node` (`24.16.0`). */
-    readonly nodeVersion: string;
-    /** CPU arch, e.g. `process.arch` (`arm64` | `x64`). */
-    readonly arch: string;
+	/** Node version, e.g. `process.versions.node` (`24.16.0`). */
+	readonly nodeVersion: string;
+	/** CPU arch, e.g. `process.arch` (`arm64` | `x64`). */
+	readonly arch: string;
 }
 /** Fetch a `<moduleDir>`'s prebuild for `target`. Test seam. */
 export type PrebuildFetchFn = (moduleDir: string, target: PrebuildTarget) => Promise<void>;
 export interface EnsureNativePrebuildsOptions {
-    readonly logger: IScopedLogger;
-    /** Defaults to the running process (`process.versions.node` / `process.arch`). */
-    readonly target?: PrebuildTarget;
-    /** Override the native package set (tests). */
-    readonly packages?: readonly string[];
-    /** Override the fetcher (tests). Production uses the bundled `prebuild-install`. */
-    readonly fetchPrebuild?: PrebuildFetchFn;
+	readonly logger: IScopedLogger;
+	/** Defaults to the running process (`process.versions.node` / `process.arch`). */
+	readonly target?: PrebuildTarget;
+	/** Override the native package set (tests). */
+	readonly packages?: readonly string[];
+	/** Override the fetcher (tests). Production uses the bundled `prebuild-install`. */
+	readonly fetchPrebuild?: PrebuildFetchFn;
 }
 /** Bounded recursive scan for ANY `*.node` file under `dir`. */
 export declare function hasDotNode(dir: string, maxDepth: number): boolean;
 /**
- * Ensure every traditional native in `<closureDir>/node_modules` carries its
- * compiled `.node`, fetching the prebuild for the running ABI when missing.
- *
- * A NO-OP when nothing is missing (docker / tests) and when a native package is
- * absent from the closure. Never throws for a single package's fetch failure —
- * it logs and continues so the downstream `findMissingNativePrebuilds`
- * validator makes the final swap/abort decision. Returns the packages whose
- * prebuild was successfully fetched (for logging/tests).
- */
+* Ensure every traditional native in `<closureDir>/node_modules` carries its
+* compiled `.node`, fetching the prebuild for the running ABI when missing.
+*
+* A NO-OP when nothing is missing (docker / tests) and when a native package is
+* absent from the closure. Never throws for a single package's fetch failure —
+* it logs and continues so the downstream `findMissingNativePrebuilds`
+* validator makes the final swap/abort decision. Returns the packages whose
+* prebuild was successfully fetched (for logging/tests).
+*/
 export declare function ensureNativePrebuilds(closureDir: string, options: EnsureNativePrebuildsOptions): Promise<readonly string[]>;

package/dist/kernel/deps/manifest-native-deps.d.ts

@@ -1,42 +1,42 @@
-import { IScopedLogger } from '@camstack/types';
+import type { IScopedLogger } from "@camstack/types";
 /**
- * Native node modules an addon needs at runtime but cannot be bundled
- * (`.node` binary files require ABI-matched compilation). Mirror of the
- * Python `requirements.txt` pattern in `manifest-python-deps.ts` —
- * declared in the addon's `package.json` under `camstack.nativeDependencies`,
- * installed per-addon at install time so the host's regular `npm install`
- * doesn't pull in the union of every camera driver's native deps.
- *
- * Phase E of the bundles + builder modernization spec
- * (`docs/superpowers/specs/2026-05-09-bundles-and-builder-modernization-design.md`).
- *
- * Idempotent: hashes the `nativeDependencies` map and writes a marker
- * to `<addonDir>/.camstack-native-deps-installed`. Re-installing only
- * happens when the declared set changes.
- *
- * Failure modes:
- *   - manifest doesn't declare `nativeDependencies` (or declares empty) → no-op
- *   - `npm install` fails → throws (caller decides whether to abort install)
- *   - rebuild step fails → logs warning + continues (install may still
- *     work if prebuilt binaries shipped in the package cover the host
- *     ABI; surface a clear error at first `import` of the native module
- *     otherwise).
- */
+* Native node modules an addon needs at runtime but cannot be bundled
+* (`.node` binary files require ABI-matched compilation). Mirror of the
+* Python `requirements.txt` pattern in `manifest-python-deps.ts` —
+* declared in the addon's `package.json` under `camstack.nativeDependencies`,
+* installed per-addon at install time so the host's regular `npm install`
+* doesn't pull in the union of every camera driver's native deps.
+*
+* Phase E of the bundles + builder modernization spec
+* (`docs/superpowers/specs/2026-05-09-bundles-and-builder-modernization-design.md`).
+*
+* Idempotent: hashes the `nativeDependencies` map and writes a marker
+* to `<addonDir>/.camstack-native-deps-installed`. Re-installing only
+* happens when the declared set changes.
+*
+* Failure modes:
+*   - manifest doesn't declare `nativeDependencies` (or declares empty) → no-op
+*   - `npm install` fails → throws (caller decides whether to abort install)
+*   - rebuild step fails → logs warning + continues (install may still
+*     work if prebuilt binaries shipped in the package cover the host
+*     ABI; surface a clear error at first `import` of the native module
+*     otherwise).
+*/
 export declare function installManifestNativeDeps(addonDir: string, pkgRaw: Record<string, unknown>, logger: IScopedLogger, registry?: string, npmCacheDir?: string): Promise<void>;
 /**
- * Propagate PREBUILT native modules from a bundled addon copy's own
- * `node_modules` (the packaged-desktop 'local' source at
- * `<resources>/addons/<addon>`) into the freshly-copied target
- * (`<data>/addons/@camstack/<addon>`), BEFORE the target's `npm install` runs.
- *
- * Why (Mac desktop first-boot FATAL, 2026-07-21): `installCopy` copies only
- * `dist/` then `npm install`s the addon's runtime deps. On a toolchain-less Mac
- * that install leaves the traditional native `better-sqlite3` SOURCE-ONLY in
- * `<addon>/node_modules` — a broken copy that then SHADOWS the good hoisted
- * `.node` NODE_PATH would otherwise resolve, crashing the runner with "Could
- * not locate the bindings file". Seeding the prebuilt copy here makes the npm
- * install treat the native as satisfied (no re-run of `prebuild-install`), so
- * the good `.node` stays in place. A no-op in dev / docker where the source
- * carries no bundled natives.
- */
+* Propagate PREBUILT native modules from a bundled addon copy's own
+* `node_modules` (the packaged-desktop 'local' source at
+* `<resources>/addons/<addon>`) into the freshly-copied target
+* (`<data>/addons/@camstack/<addon>`), BEFORE the target's `npm install` runs.
+*
+* Why (Mac desktop first-boot FATAL, 2026-07-21): `installCopy` copies only
+* `dist/` then `npm install`s the addon's runtime deps. On a toolchain-less Mac
+* that install leaves the traditional native `better-sqlite3` SOURCE-ONLY in
+* `<addon>/node_modules` — a broken copy that then SHADOWS the good hoisted
+* `.node` NODE_PATH would otherwise resolve, crashing the runner with "Could
+* not locate the bindings file". Seeding the prebuilt copy here makes the npm
+* install treat the native as satisfied (no re-run of `prebuild-install`), so
+* the good `.node` stays in place. A no-op in dev / docker where the source
+* carries no bundled natives.
+*/
 export declare function copyBundledNativeModules(sourceDir: string, targetDir: string, logger: IScopedLogger): void;

package/dist/kernel/deps/manifest-python-deps.d.ts

@@ -1,20 +1,20 @@
-import { AddonDeclaration, IAddonDepsManager, IScopedLogger } from '@camstack/types';
+import type { AddonDeclaration, IAddonDepsManager, IScopedLogger } from "@camstack/types";
 /**
- * Auto-install the pip requirements file declared in an addon's manifest
- * (`camstack.addons[].python.requirements`) into the embedded portable
- * Python before `onInitialize()` runs.
- *
- * Idempotent: `installPythonRequirements` skips when the file's content
- * hash matches an existing marker under `<python>/.requirements-installed/`.
- * Re-downloading the embedded Python wipes the marker dir together with
- * site-packages, forcing a fresh re-install.
- *
- * Failure modes:
- *   - manifest doesn't declare `python.requirements` → no-op.
- *   - embedded Python download fails → warn + continue. The addon's
- *     own `onInitialize` will raise a precise error if Python is
- *     actually required.
- *   - pip install fails → propagate so the group-runner aborts boot
- *     loudly (vs silently shipping a half-installed env).
- */
+* Auto-install the pip requirements file declared in an addon's manifest
+* (`camstack.addons[].python.requirements`) into the embedded portable
+* Python before `onInitialize()` runs.
+*
+* Idempotent: `installPythonRequirements` skips when the file's content
+* hash matches an existing marker under `<python>/.requirements-installed/`.
+* Re-downloading the embedded Python wipes the marker dir together with
+* site-packages, forcing a fresh re-install.
+*
+* Failure modes:
+*   - manifest doesn't declare `python.requirements` → no-op.
+*   - embedded Python download fails → warn + continue. The addon's
+*     own `onInitialize` will raise a precise error if Python is
+*     actually required.
+*   - pip install fails → propagate so the group-runner aborts boot
+*     loudly (vs silently shipping a half-installed env).
+*/
 export declare function installManifestPythonDeps(declaration: AddonDeclaration, addonDir: string, deps: IAddonDepsManager, logger: IScopedLogger): Promise<void>;

package/dist/kernel/deps/manifest-system-deps.d.ts

@@ -1,18 +1,18 @@
-import { AddonDeclaration, IScopedLogger } from '@camstack/types';
-import { PackageInstallRequest, PackageInstallResult } from './system-package-broker.js';
-import { SystemPackageManager } from './system-package-allowlist.js';
-export type { SystemPackageManager } from './system-package-allowlist.js';
+import type { AddonDeclaration, IScopedLogger } from "@camstack/types";
+import type { PackageInstallRequest, PackageInstallResult } from "./system-package-broker.js";
+import type { SystemPackageManager } from "./system-package-allowlist.js";
+export type { SystemPackageManager } from "./system-package-allowlist.js";
 /** Test seams — production callers omit these. */
 export interface InstallManifestSystemDepsOptions {
-    readonly hasBinary?: (binary: string) => Promise<boolean>;
-    readonly detectManager?: () => Promise<SystemPackageManager | null>;
-    readonly run?: (command: string, args: readonly string[]) => Promise<void>;
-    readonly platform?: NodeJS.Platform;
-    readonly helperAvailable?: () => Promise<boolean>;
-    readonly requestInstall?: (req: PackageInstallRequest) => Promise<PackageInstallResult>;
+	readonly hasBinary?: (binary: string) => Promise<boolean>;
+	readonly detectManager?: () => Promise<SystemPackageManager | null>;
+	readonly run?: (command: string, args: readonly string[]) => Promise<void>;
+	readonly platform?: NodeJS.Platform;
+	readonly helperAvailable?: () => Promise<boolean>;
+	readonly requestInstall?: (req: PackageInstallRequest) => Promise<PackageInstallResult>;
 }
 /**
- * Satisfy every `systemDependencies` entry the declaration carries.
- * Resolves regardless of outcome — see the docblock.
- */
+* Satisfy every `systemDependencies` entry the declaration carries.
+* Resolves regardless of outcome — see the docblock.
+*/
 export declare function installManifestSystemDeps(declaration: AddonDeclaration, logger: IScopedLogger, options?: InstallManifestSystemDepsOptions): Promise<void>;

package/dist/kernel/deps/npm-command.d.ts

@@ -1,60 +1,60 @@
-import { IScopedLogger } from '@camstack/types';
+import type { IScopedLogger } from "@camstack/types";
 /** How the caller must spawn npm: `execFile(command, [...argsPrefix, ...npmArgs])`. */
 export interface NpmInvocation {
-    readonly command: string;
-    readonly argsPrefix: readonly string[];
+	readonly command: string;
+	readonly argsPrefix: readonly string[];
 }
 export interface ResolveNpmInvocationOptions {
-    /** Directory that holds (or receives) the bootstrapped npm package. */
-    readonly cacheDir: string;
-    /** npm registry base URL; defaults to the public registry. */
-    readonly registry?: string | undefined;
-    readonly logger: IScopedLogger;
-    /** Test seams — production callers omit all of these. */
-    readonly probeSystemNpm?: () => Promise<boolean>;
-    readonly fetchJson?: (url: string) => Promise<unknown>;
-    readonly downloadTarball?: (url: string, destTgz: string) => Promise<void>;
-    readonly extractTarball?: (tgzPath: string, destDir: string) => Promise<void>;
+	/** Directory that holds (or receives) the bootstrapped npm package. */
+	readonly cacheDir: string;
+	/** npm registry base URL; defaults to the public registry. */
+	readonly registry?: string | undefined;
+	readonly logger: IScopedLogger;
+	/** Test seams — production callers omit all of these. */
+	readonly probeSystemNpm?: () => Promise<boolean>;
+	readonly fetchJson?: (url: string) => Promise<unknown>;
+	readonly downloadTarball?: (url: string, destTgz: string) => Promise<void>;
+	readonly extractTarball?: (tgzPath: string, destDir: string) => Promise<void>;
 }
 /** Test-only: reset the process-wide memo. */
 export declare function __clearNpmInvocationCacheForTests(): void;
 export declare function resolveNpmInvocation(options: ResolveNpmInvocationOptions): Promise<NpmInvocation>;
 export interface RunNpmOptions {
-    readonly cacheDir: string;
-    /** The environment to derive the child's from. Defaults to `process.env`. */
-    readonly env?: NodeJS.ProcessEnv;
-    readonly registry?: string | undefined;
-    readonly logger: IScopedLogger;
-    readonly cwd?: string;
-    readonly timeout?: number;
+	readonly cacheDir: string;
+	/** The environment to derive the child's from. Defaults to `process.env`. */
+	readonly env?: NodeJS.ProcessEnv;
+	readonly registry?: string | undefined;
+	readonly logger: IScopedLogger;
+	readonly cwd?: string;
+	readonly timeout?: number;
 }
 /**
- * Resolve a working npm (system → bootstrapped → bootstrap) and run it with
- * `args`. The ONE entry point every installer code path uses instead of a raw
- * `execFile('npm', ...)` — so "npm missing on this host" is either solved
- * (bootstrap) or a LOUD, actionable error, never a swallowed ENOENT.
- */
+* Resolve a working npm (system → bootstrapped → bootstrap) and run it with
+* `args`. The ONE entry point every installer code path uses instead of a raw
+* `execFile('npm', ...)` — so "npm missing on this host" is either solved
+* (bootstrap) or a LOUD, actionable error, never a swallowed ENOENT.
+*/
 /**
- * The environment the npm child gets: the caller's, plus the directory of the
- * Node we are running, FIRST on PATH.
- *
- * Why: on a packaged desktop there is no system npm and no system node — the
- * app ships one bundled Node and the process runs with a bare launchd PATH
- * (`/usr/bin:/bin:/usr/sbin:/sbin`, measured on the Mac-mini agent). npm runs
- * every lifecycle script through `sh -c`, so a script spelled `node install.js`
- * — which is how `node-av`, `better-sqlite3`, `esbuild` and our own closure
- * postinstall are all spelled — dies with `sh: node: command not found`, and
- * the whole install fails at exit 127 with no native prebuilds and no patches.
- *
- * Prepending (not appending) is deliberate: the lifecycle scripts of THIS
- * closure must run on the Node that will load it, not on whatever older Node a
- * host happens to have earlier on PATH.
- *
- * Idempotent, because npm invocations nest: a directory already in front is
- * left alone rather than added again.
- */
+* The environment the npm child gets: the caller's, plus the directory of the
+* Node we are running, FIRST on PATH.
+*
+* Why: on a packaged desktop there is no system npm and no system node — the
+* app ships one bundled Node and the process runs with a bare launchd PATH
+* (`/usr/bin:/bin:/usr/sbin:/sbin`, measured on the Mac-mini agent). npm runs
+* every lifecycle script through `sh -c`, so a script spelled `node install.js`
+* — which is how `node-av`, `better-sqlite3`, `esbuild` and our own closure
+* postinstall are all spelled — dies with `sh: node: command not found`, and
+* the whole install fails at exit 127 with no native prebuilds and no patches.
+*
+* Prepending (not appending) is deliberate: the lifecycle scripts of THIS
+* closure must run on the Node that will load it, not on whatever older Node a
+* host happens to have earlier on PATH.
+*
+* Idempotent, because npm invocations nest: a directory already in front is
+* left alone rather than added again.
+*/
 export declare function buildNpmChildEnv(env: NodeJS.ProcessEnv, execPath: string): NodeJS.ProcessEnv;
 export declare function runNpm(args: readonly string[], options: RunNpmOptions): Promise<{
-    stdout: string;
-    stderr: string;
+	stdout: string;
+	stderr: string;
 }>;

package/dist/kernel/deps/system-package-allowlist.d.ts

@@ -1,12 +1,12 @@
 /**
- * Packages the privileged helper will install (D326).
- *
- * The helper process reads `scripts/docker/pkg-allowlist.json` (baked into
- * the image). This module is the runner-side copy of the same list, so an
- * unknown package is refused before a socket write. Keep them identical —
- * `scripts/check-pkg-allowlist.ts` fails CI when they drift.
- */
-export type SystemPackageManager = 'apt' | 'apk' | 'dnf' | 'brew';
-export type DistroPackageManager = Exclude<SystemPackageManager, 'brew'>;
+* Packages the privileged helper will install (D326).
+*
+* The helper process reads `scripts/docker/pkg-allowlist.json` (baked into
+* the image). This module is the runner-side copy of the same list, so an
+* unknown package is refused before a socket write. Keep them identical —
+* `scripts/check-pkg-allowlist.ts` fails CI when they drift.
+*/
+export type SystemPackageManager = "apt" | "apk" | "dnf" | "brew";
+export type DistroPackageManager = Exclude<SystemPackageManager, "brew">;
 export declare const DISTRO_PACKAGE_ALLOWLIST: Readonly<Record<DistroPackageManager, readonly string[]>>;
 export declare function packageIsAllowlisted(manager: SystemPackageManager, packageName: string): boolean;

package/dist/kernel/deps/system-package-broker.d.ts

@@ -1,31 +1,31 @@
-import { SystemPackageManager } from './system-package-allowlist.js';
+import type { SystemPackageManager } from "./system-package-allowlist.js";
 export interface PackageInstallRequest {
-    readonly addonId: string;
-    readonly binary: string;
-    readonly manager: SystemPackageManager;
-    readonly packageName: string;
+	readonly addonId: string;
+	readonly binary: string;
+	readonly manager: SystemPackageManager;
+	readonly packageName: string;
 }
 export interface PackageInstallResult {
-    readonly ok: boolean;
-    readonly error?: string;
+	readonly ok: boolean;
+	readonly error?: string;
 }
 export type PackageInstallDecision = {
-    readonly kind: 'helper';
+	readonly kind: "helper";
 } | {
-    readonly kind: 'local';
+	readonly kind: "local";
 } | {
-    readonly kind: 'refuse';
-    readonly reason: 'not-allowlisted' | 'helper-unavailable';
+	readonly kind: "refuse";
+	readonly reason: "not-allowlisted" | "helper-unavailable";
 };
 /**
- * Who is allowed to run the package manager for this request.
- *
- * Apt/apk/dnf need root. In the CamStack container that is the
- * `camstack-pkgd` helper, not the runner and not hub-main (both uid
- * 1001). Brew is owned by the logged-in user, so it stays in-process.
- */
+* Who is allowed to run the package manager for this request.
+*
+* Apt/apk/dnf need root. In the CamStack container that is the
+* `camstack-pkgd` helper, not the runner and not hub-main (both uid
+* 1001). Brew is owned by the logged-in user, so it stays in-process.
+*/
 export declare function decidePackageInstall(input: {
-    readonly manager: SystemPackageManager;
-    readonly packageName: string;
-    readonly helperAvailable: boolean;
+	readonly manager: SystemPackageManager;
+	readonly packageName: string;
+	readonly helperAvailable: boolean;
 }): PackageInstallDecision;

package/dist/kernel/deps/system-package-client.d.ts

@@ -1,9 +1,9 @@
-import { PackageInstallRequest, PackageInstallResult } from './system-package-broker.js';
+import type { PackageInstallRequest, PackageInstallResult } from "./system-package-broker.js";
 /** Default path the entrypoint binds before dropping to uid 1001. */
 export declare const DEFAULT_PKGD_SOCKET = "/run/camstack/pkgd.sock";
 export declare function pkgdSocketPath(): string;
 export declare function privilegedHelperAvailable(socketPath?: string): boolean;
 /**
- * One JSON object per line. The helper answers one request per connection.
- */
+* One JSON object per line. The helper answers one request per connection.
+*/
 export declare function requestPrivilegedInstall(req: PackageInstallRequest, socketPath?: string, timeoutMs?: number): Promise<PackageInstallResult>;

package/dist/kernel/device-registry.d.ts

@@ -1,29 +1,29 @@
-import { IDevice, IDeviceRegistry } from '@camstack/types';
+import type { IDevice, IDeviceRegistry } from "@camstack/types";
 export declare class DeviceRegistry implements IDeviceRegistry {
-    /** Primary map: every registered device keyed by its progressive
-     *  numeric id. Numeric id is the system-wide unique handle; stableId
-     *  is integration-scoped and only used at external boundaries. */
-    private readonly byId;
-    /** Addon scoping index: addonId → set of numeric device ids owned
-     *  by that addon. Lets `getAllForAddon` and per-addon teardown stay
-     *  O(1) per lookup without a second primary table. */
-    private readonly byAddon;
-    /** Inverse of byAddon for the single-device case. */
-    private readonly idToAddon;
-    register(addonId: string, device: IDevice): void;
-    /** Owning addonId for a registered numeric id, or null if not registered. */
-    getAddonId(id: number): string | null;
-    /** Look up any registered device by its progressive numeric id. */
-    getById(id: number): IDevice | null;
-    getAllForAddon(addonId: string): readonly IDevice[];
-    getChildren(parentDeviceId: number): readonly IDevice[];
-    remove(deviceId: number): void;
-    getAll(): readonly IDevice[];
-    /** All devices with their owning addonId. */
-    getAllWithAddonId(): readonly {
-        addonId: string;
-        device: IDevice;
-    }[];
-    /** All addonIds that have at least one registered device. */
-    getAddonIds(): readonly string[];
+	/** Primary map: every registered device keyed by its progressive
+	*  numeric id. Numeric id is the system-wide unique handle; stableId
+	*  is integration-scoped and only used at external boundaries. */
+	private readonly byId;
+	/** Addon scoping index: addonId → set of numeric device ids owned
+	*  by that addon. Lets `getAllForAddon` and per-addon teardown stay
+	*  O(1) per lookup without a second primary table. */
+	private readonly byAddon;
+	/** Inverse of byAddon for the single-device case. */
+	private readonly idToAddon;
+	register(addonId: string, device: IDevice): void;
+	/** Owning addonId for a registered numeric id, or null if not registered. */
+	getAddonId(id: number): string | null;
+	/** Look up any registered device by its progressive numeric id. */
+	getById(id: number): IDevice | null;
+	getAllForAddon(addonId: string): readonly IDevice[];
+	getChildren(parentDeviceId: number): readonly IDevice[];
+	remove(deviceId: number): void;
+	getAll(): readonly IDevice[];
+	/** All devices with their owning addonId. */
+	getAllWithAddonId(): readonly {
+		addonId: string;
+		device: IDevice;
+	}[];
+	/** All addonIds that have at least one registered device. */
+	getAddonIds(): readonly string[];
 }

package/dist/kernel/event-loop-stall-monitor.d.ts

@@ -1,41 +1,41 @@
-import { IScopedLogger } from '@camstack/types';
+import type { IScopedLogger } from "@camstack/types";
 /** Tick period. Small enough to bound attribution error, large enough to cost
- *  nothing on a process already doing frame work. */
-export declare const STALL_TICK_MS = 1000;
+*  nothing on a process already doing frame work. */
+export declare const STALL_TICK_MS = 1e3;
 /**
- * Report a freeze only past this. The runner's own inference deadline is 20s
- * and the observed freezes run 22-88s, so this is far below the signal while
- * staying clear of ordinary scheduling jitter (a busy frame path routinely
- * overruns a 1s timer by tens of ms).
- */
-export declare const STALL_REPORT_MS = 2000;
+* Report a freeze only past this. The runner's own inference deadline is 20s
+* and the observed freezes run 22-88s, so this is far below the signal while
+* staying clear of ordinary scheduling jitter (a busy frame path routinely
+* overruns a 1s timer by tens of ms).
+*/
+export declare const STALL_REPORT_MS = 2e3;
 export interface StallVerdict {
-    /** How long the loop was actually blocked. */
-    readonly stallMs: number;
-    /** GC pause time inside the stall window. */
-    readonly gcMs: number;
-    /** Number of GC pauses in the window. */
-    readonly gcCount: number;
-    /** Longest single GC pause in the window. */
-    readonly longestGcMs: number;
-    /** What the evidence says. */
-    readonly cause: 'gc' | 'synchronous-block' | 'mixed';
+	/** How long the loop was actually blocked. */
+	readonly stallMs: number;
+	/** GC pause time inside the stall window. */
+	readonly gcMs: number;
+	/** Number of GC pauses in the window. */
+	readonly gcCount: number;
+	/** Longest single GC pause in the window. */
+	readonly longestGcMs: number;
+	/** What the evidence says. */
+	readonly cause: "gc" | "synchronous-block" | "mixed";
 }
 /**
- * Attribute a freeze. Pure, because this is the ONE judgement the whole module
- * exists to make and it must be testable without freezing a real event loop.
- *
- * `gc` when garbage collection accounts for most of the stall; a
- * `synchronous-block` when it accounts for almost none — that verdict points
- * away from the heap entirely and at whatever ran without yielding.
- */
+* Attribute a freeze. Pure, because this is the ONE judgement the whole module
+* exists to make and it must be testable without freezing a real event loop.
+*
+* `gc` when garbage collection accounts for most of the stall; a
+* `synchronous-block` when it accounts for almost none — that verdict points
+* away from the heap entirely and at whatever ran without yielding.
+*/
 export declare function attributeStall(stallMs: number, gcMs: number, gcCount: number, longestGcMs: number): StallVerdict;
 /**
- * Start watching. Returns a stop function; safe to call twice.
- *
- * Never throws into the caller: a diagnostic that can take the detection
- * process down is worse than no diagnostic. `PerformanceObserver` for `gc` is
- * unavailable in some embedded runtimes, and that must degrade to
- * stall-detection-without-attribution rather than a boot failure.
- */
+* Start watching. Returns a stop function; safe to call twice.
+*
+* Never throws into the caller: a diagnostic that can take the detection
+* process down is worse than no diagnostic. `PerformanceObserver` for `gc` is
+* unavailable in some embedded runtimes, and that must degrade to
+* stall-detection-without-attribution rather than a boot failure.
+*/
 export declare function startEventLoopStallMonitor(logger: IScopedLogger, reportThresholdMs?: number): () => void;