@doriandev/devcc 0.1.2

package/dist/devcc/components/styled.js

@@ -0,0 +1,35 @@
+import { bold as boldChunk, dim as dimChunk, fg, StyledText } from "@opentui/core";
+import { theme } from "../app/theme.js";
+/**
+ * Helpers for composing `StyledText` programmatically.
+ *
+ * The `t` template literal is convenient for fixed strings; these helpers cover
+ * the dynamic case (variable numbers of coloured segments) without fighting the
+ * template syntax.
+ */
+export function chunk(text, color = theme.text) {
+    return fg(color)(text);
+}
+export function bold(text, color = theme.textBright) {
+    return boldChunk(fg(color)(text));
+}
+export function dim(text) {
+    return dimChunk(fg(theme.textDim)(text));
+}
+export function styled(...parts) {
+    return new StyledText(parts.map((part) => (typeof part === "string" ? chunk(part) : part)));
+}
+export function joinStyled(parts, separator, separatorColor = theme.textDim) {
+    const chunks = [];
+    for (const [index, part] of parts.entries()) {
+        if (index > 0)
+            chunks.push(chunk(separator, separatorColor));
+        chunks.push(...part.chunks);
+    }
+    return new StyledText(chunks);
+}
+/** Total display length of a styled line, for right-alignment maths. */
+export function styledLength(text) {
+    return text.chunks.reduce((total, part) => total + part.text.length, 0);
+}
+//# sourceMappingURL=styled.js.map

package/dist/devcc/components/styled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styled.js","sourceRoot":"","sources":["../../../src/devcc/components/styled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,GAAG,IAAI,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAkB,MAAM,eAAe,CAAA;AAClG,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC;;;;;;GAMG;AAEH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,QAAgB,KAAK,CAAC,IAAI;IAC5D,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,QAAgB,KAAK,CAAC,UAAU;IACjE,OAAO,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAG,KAA6B;IACrD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAC7F,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAmB,EACnB,SAAiB,EACjB,cAAc,GAAG,KAAK,CAAC,OAAO;IAE9B,MAAM,MAAM,GAAgB,EAAE,CAAA;IAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;QAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;AACzE,CAAC"}

package/dist/devcc/core/commands.d.ts

@@ -0,0 +1,89 @@
+import type { DependencyService } from "../deps/DependencyService.js";
+import type { GitService } from "../git/GitService.js";
+import type { LogStore } from "../logs/LogBuffer.js";
+import type { ProcessManager } from "../processes/ProcessManager.js";
+import type { ServiceManager } from "../services/ServiceManager.js";
+import type { ProjectEntry } from "../projects/ProjectRegistry.js";
+import type { SystemMonitor } from "../system/SystemMonitor.js";
+import type { AppStore, NotificationLevel, ViewId } from "./state.js";
+/**
+ * Everything a command is allowed to touch.
+ *
+ * Commands are the single extension point: the palette, the keymap and any
+ * user-provided config entry all end up here, so a new capability only has to
+ * be registered once.
+ */
+export interface CommandContext {
+    store: AppStore;
+    processes: ProcessManager;
+    services: ServiceManager;
+    git: GitService;
+    logs: LogStore;
+    system: SystemMonitor;
+    deps: DependencyService;
+    navigate: (view: ViewId) => void;
+    notify: (level: NotificationLevel, message: string, detail?: string) => void;
+    /** Modal yes/no. Resolves false when dismissed. */
+    confirm: (title: string, message: string) => Promise<boolean>;
+    /** Modal single-line prompt. Resolves null when cancelled. */
+    prompt: (title: string, placeholder?: string) => Promise<string | null>;
+    /** Open the in-app manual. */
+    showHelp: () => void;
+    runScript: (name: string) => Promise<void>;
+    /** Update one dependency to `version`, after confirmation. */
+    updateDependency: (name: string, version: string) => Promise<void>;
+    /** Projects the switcher can offer, current one first. */
+    listProjects: () => ProjectEntry[];
+    /** Projects currently open, in the order they were opened. */
+    openProjects: () => ProjectEntry[];
+    /** Open a project (or bring an open one to the front) without closing others. */
+    switchProject: (path: string) => Promise<void>;
+    /** Close an open project, stopping what devcc started there. Defaults to the current one. */
+    closeProject: (path?: string) => Promise<void>;
+    quit: () => void;
+}
+export interface CommandDefinition {
+    id: string;
+    title: string;
+    category?: string;
+    /** Displayed hint, e.g. `r`. Key handling itself lives in the keymap. */
+    shortcut?: string;
+    keywords?: string[];
+    /** Hide the command when it cannot apply right now. */
+    when?: (context: CommandContext) => boolean;
+    /** Ask for confirmation before running. Used for destructive operations. */
+    confirm?: {
+        title: string;
+        message: string;
+    };
+    execute: (context: CommandContext) => Promise<void> | void;
+}
+export interface CommandRegistryEvents {
+    changed: [];
+}
+/**
+ * Central command registry. Ids are unique; re-registering an id replaces it,
+ * which is what lets project config override a built-in.
+ */
+export declare class CommandRegistry {
+    private readonly commands;
+    register(command: CommandDefinition): void;
+    registerAll(commands: readonly CommandDefinition[]): void;
+    unregister(id: string): boolean;
+    /** Drop every command. Used when the dashboard reattaches to another project. */
+    clear(): void;
+    has(id: string): boolean;
+    get(id: string): CommandDefinition | undefined;
+    list(): CommandDefinition[];
+    /** Commands whose `when` guard passes right now. */
+    available(context: CommandContext): CommandDefinition[];
+    /** Fuzzy search over `category title keywords`. */
+    search(query: string, context: CommandContext, limit?: number): CommandDefinition[];
+    /**
+     * Run a command by id, honouring its `confirm` guard.
+     * Returns false when the command does not exist or the user declined.
+     */
+    run(id: string, context: CommandContext): Promise<boolean>;
+}
+export declare function searchText(command: CommandDefinition): string;
+//# sourceMappingURL=commands.d.ts.map

package/dist/devcc/core/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/devcc/core/commands.ts"],"names":[],"mappings":"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"}

package/dist/devcc/core/commands.js

@@ -0,0 +1,68 @@
+import { fuzzyFilter } from "../utils/fuzzy.js";
+/**
+ * Central command registry. Ids are unique; re-registering an id replaces it,
+ * which is what lets project config override a built-in.
+ */
+export class CommandRegistry {
+    commands = new Map();
+    register(command) {
+        this.commands.set(command.id, command);
+    }
+    registerAll(commands) {
+        for (const command of commands)
+            this.register(command);
+    }
+    unregister(id) {
+        return this.commands.delete(id);
+    }
+    /** Drop every command. Used when the dashboard reattaches to another project. */
+    clear() {
+        this.commands.clear();
+    }
+    has(id) {
+        return this.commands.has(id);
+    }
+    get(id) {
+        return this.commands.get(id);
+    }
+    list() {
+        return [...this.commands.values()];
+    }
+    /** Commands whose `when` guard passes right now. */
+    available(context) {
+        return this.list().filter((command) => (command.when ? safeWhen(command, context) : true));
+    }
+    /** Fuzzy search over `category title keywords`. */
+    search(query, context, limit = 40) {
+        const candidates = this.available(context);
+        return fuzzyFilter(candidates, query, searchText, limit).map((match) => match.item);
+    }
+    /**
+     * Run a command by id, honouring its `confirm` guard.
+     * Returns false when the command does not exist or the user declined.
+     */
+    async run(id, context) {
+        const command = this.commands.get(id);
+        if (!command)
+            return false;
+        if (command.confirm) {
+            const confirmed = await context.confirm(command.confirm.title, command.confirm.message);
+            if (!confirmed)
+                return false;
+        }
+        await command.execute(context);
+        return true;
+    }
+}
+export function searchText(command) {
+    return [command.category, command.title, ...(command.keywords ?? [])].filter(Boolean).join(" ");
+}
+function safeWhen(command, context) {
+    try {
+        return command.when?.(context) ?? true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/devcc/core/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/devcc/core/commands.ts"],"names":[],"mappings":"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"}

package/dist/devcc/core/config.d.ts

@@ -0,0 +1,81 @@
+import type { ProcessDefinition } from "../processes/ManagedProcess.js";
+import type { LogLevel } from "../utils/logger.js";
+/** A command declared in project config: runs an executable and streams its logs. */
+export interface CommandConfigEntry {
+    id: string;
+    title: string;
+    category?: string;
+    command: string;
+    args?: string[];
+    cwd?: string;
+    keywords?: string[];
+    /** Require a yes/no confirmation before running. */
+    confirm?: {
+        title: string;
+        message: string;
+    } | boolean;
+}
+/** An extra port/HTTP endpoint to watch in the Services view. */
+export interface ServiceConfigEntry {
+    id: string;
+    name: string;
+    port: number;
+    host?: string;
+    healthPath?: string;
+    category?: "container" | "database" | "runtime" | "ai" | "web";
+}
+export interface RefreshIntervals {
+    system?: number;
+    services?: number;
+    git?: number;
+    clock?: number;
+}
+export interface DevccConfig {
+    /** Overrides the project name shown in the header. */
+    name?: string;
+    /**
+     * Extra project paths to offer in the project switcher, absolute or relative
+     * to this project. Recents and sibling directories are found automatically.
+     */
+    projects?: string[];
+    /** Extra directories to scan for sibling projects (default: the parent). */
+    projectSearchDirs?: string[];
+    processes?: ProcessDefinition[];
+    commands?: CommandConfigEntry[];
+    services?: ServiceConfigEntry[];
+    refresh?: RefreshIntervals;
+    /** Cap for each log source's ring buffer. */
+    maxLogLines?: number;
+    logLevel?: LogLevel;
+}
+export type ResolvedConfig = Required<Pick<DevccConfig, "processes" | "commands" | "services" | "projects" | "projectSearchDirs">> & Omit<DevccConfig, "processes" | "commands" | "services" | "projects" | "projectSearchDirs"> & {
+    refresh: Required<RefreshIntervals>;
+};
+export declare const DEFAULT_REFRESH: Required<RefreshIntervals>;
+export declare const EMPTY_CONFIG: ResolvedConfig;
+/** Identity helper that gives config files full type checking and completion. */
+export declare function defineConfig(config: DevccConfig): DevccConfig;
+export declare const CONFIG_FILENAMES: readonly [".devcc.ts", "devcc.config.ts", ".devcc.mts", "devcc.config.mts", ".devcc.js", "devcc.config.js", ".devcc.mjs", "devcc.config.mjs", ".devcc.json"];
+export declare function findConfigFile(rootDir: string, exists?: (path: string) => boolean): string | null;
+export interface ValidationResult {
+    config: ResolvedConfig;
+    issues: string[];
+}
+/**
+ * Validate and normalise a raw config object.
+ *
+ * Invalid entries are dropped with an explanatory issue rather than throwing:
+ * a typo in one process definition must not stop the dashboard from starting.
+ */
+export declare function validateConfig(raw: unknown): ValidationResult;
+export interface LoadedConfig extends ValidationResult {
+    filePath: string | null;
+}
+/**
+ * Load project config if present.
+ *
+ * TypeScript config files are transpiled on the fly with jiti so `.devcc.ts`
+ * works identically under Bun and Node.
+ */
+export declare function loadConfig(rootDir: string): Promise<LoadedConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/devcc/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/devcc/core/config.ts"],"names":[],"mappings":"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"}

package/dist/devcc/core/config.js

@@ -0,0 +1,313 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { errorMessage } from "../utils/errors.js";
+import { isLogLevel } from "../utils/logger.js";
+export const DEFAULT_REFRESH = {
+    system: 1_500,
+    services: 5_000,
+    git: 8_000,
+    clock: 1_000,
+};
+export const EMPTY_CONFIG = {
+    processes: [],
+    commands: [],
+    services: [],
+    projects: [],
+    projectSearchDirs: [],
+    refresh: DEFAULT_REFRESH,
+};
+/** Identity helper that gives config files full type checking and completion. */
+export function defineConfig(config) {
+    return config;
+}
+export const CONFIG_FILENAMES = [
+    ".devcc.ts",
+    "devcc.config.ts",
+    ".devcc.mts",
+    "devcc.config.mts",
+    ".devcc.js",
+    "devcc.config.js",
+    ".devcc.mjs",
+    "devcc.config.mjs",
+    ".devcc.json",
+];
+export function findConfigFile(rootDir, exists = existsSync) {
+    for (const name of CONFIG_FILENAMES) {
+        const path = join(rootDir, name);
+        if (exists(path))
+            return path;
+    }
+    return null;
+}
+const PROCESS_KINDS = ["service", "task"];
+/**
+ * Validate and normalise a raw config object.
+ *
+ * Invalid entries are dropped with an explanatory issue rather than throwing:
+ * a typo in one process definition must not stop the dashboard from starting.
+ */
+export function validateConfig(raw) {
+    const issues = [];
+    if (raw === null || typeof raw !== "object") {
+        return { config: { ...EMPTY_CONFIG }, issues: ["Config must export an object"] };
+    }
+    const input = raw;
+    const seenProcessIds = new Set();
+    const processes = [];
+    for (const [index, entry] of asArray(input.processes, "processes", issues).entries()) {
+        const record = asRecord(entry);
+        if (!record) {
+            issues.push(`processes[${index}] must be an object`);
+            continue;
+        }
+        const id = asString(record.id);
+        const command = asString(record.command);
+        if (!id) {
+            issues.push(`processes[${index}] is missing "id"`);
+            continue;
+        }
+        if (!command) {
+            issues.push(`processes[${index}] ("${id}") is missing "command"`);
+            continue;
+        }
+        if (seenProcessIds.has(id)) {
+            issues.push(`processes[${index}] duplicates id "${id}"`);
+            continue;
+        }
+        seenProcessIds.add(id);
+        const kind = asString(record.kind);
+        processes.push({
+            id,
+            name: asString(record.name) ?? id,
+            command,
+            args: asStringArray(record.args),
+            cwd: asString(record.cwd),
+            env: asStringRecord(record.env),
+            kind: kind && PROCESS_KINDS.includes(kind) ? kind : "service",
+            autoStart: record.autoStart === true,
+            url: asString(record.url),
+            port: asPositiveInt(record.port),
+            killGraceMs: asPositiveInt(record.killGraceMs),
+            restartOnCrash: record.restartOnCrash === true,
+            maxCrashRestarts: asPositiveInt(record.maxCrashRestarts),
+            crashBackoffMs: asPositiveInt(record.crashBackoffMs),
+            maxCrashBackoffMs: asPositiveInt(record.maxCrashBackoffMs),
+            healthyAfterMs: asPositiveInt(record.healthyAfterMs),
+            dependsOn: asStringArray(record.dependsOn),
+            readiness: asReadiness(record.readiness, id, issues),
+        });
+    }
+    for (const definition of processes) {
+        for (const dependency of definition.dependsOn ?? []) {
+            if (!seenProcessIds.has(dependency)) {
+                issues.push(`processes "${definition.id}": dependsOn "${dependency}" is not a declared process`);
+            }
+        }
+    }
+    const seenCommandIds = new Set();
+    const commands = [];
+    for (const [index, entry] of asArray(input.commands, "commands", issues).entries()) {
+        const record = asRecord(entry);
+        if (!record) {
+            issues.push(`commands[${index}] must be an object`);
+            continue;
+        }
+        const id = asString(record.id);
+        const command = asString(record.command);
+        if (!id || !command) {
+            issues.push(`commands[${index}] needs both "id" and "command"`);
+            continue;
+        }
+        if (seenCommandIds.has(id)) {
+            issues.push(`commands[${index}] duplicates id "${id}"`);
+            continue;
+        }
+        seenCommandIds.add(id);
+        const confirm = record.confirm;
+        commands.push({
+            id,
+            title: asString(record.title) ?? id,
+            category: asString(record.category) ?? "Project",
+            command,
+            args: asStringArray(record.args),
+            cwd: asString(record.cwd),
+            keywords: asStringArray(record.keywords),
+            confirm: confirm === true
+                ? true
+                : (() => {
+                    const confirmRecord = asRecord(confirm);
+                    const title = asString(confirmRecord?.title);
+                    const message = asString(confirmRecord?.message);
+                    return title && message ? { title, message } : undefined;
+                })(),
+        });
+    }
+    const services = [];
+    const seenServiceIds = new Set();
+    for (const [index, entry] of asArray(input.services, "services", issues).entries()) {
+        const record = asRecord(entry);
+        if (!record) {
+            issues.push(`services[${index}] must be an object`);
+            continue;
+        }
+        const id = asString(record.id);
+        const port = asPositiveInt(record.port);
+        if (!id || port === undefined) {
+            issues.push(`services[${index}] needs "id" and a numeric "port"`);
+            continue;
+        }
+        if (seenServiceIds.has(id)) {
+            issues.push(`services[${index}] duplicates id "${id}"`);
+            continue;
+        }
+        seenServiceIds.add(id);
+        services.push({
+            id,
+            name: asString(record.name) ?? id,
+            port,
+            host: asString(record.host),
+            healthPath: asString(record.healthPath),
+            category: asServiceCategory(record.category),
+        });
+    }
+    const refreshInput = asRecord(input.refresh) ?? {};
+    const refresh = {
+        system: asPositiveInt(refreshInput.system) ?? DEFAULT_REFRESH.system,
+        services: asPositiveInt(refreshInput.services) ?? DEFAULT_REFRESH.services,
+        git: asPositiveInt(refreshInput.git) ?? DEFAULT_REFRESH.git,
+        clock: asPositiveInt(refreshInput.clock) ?? DEFAULT_REFRESH.clock,
+    };
+    const logLevel = asString(input.logLevel);
+    if (logLevel && !isLogLevel(logLevel))
+        issues.push(`Unknown logLevel "${logLevel}"`);
+    return {
+        config: {
+            name: asString(input.name),
+            projects: asStringArray(input.projects) ?? [],
+            projectSearchDirs: asStringArray(input.projectSearchDirs) ?? [],
+            processes,
+            commands,
+            services,
+            refresh,
+            maxLogLines: asPositiveInt(input.maxLogLines),
+            logLevel: logLevel && isLogLevel(logLevel) ? logLevel : undefined,
+        },
+        issues,
+    };
+}
+/**
+ * Load project config if present.
+ *
+ * TypeScript config files are transpiled on the fly with jiti so `.devcc.ts`
+ * works identically under Bun and Node.
+ */
+export async function loadConfig(rootDir) {
+    const filePath = findConfigFile(rootDir);
+    if (!filePath)
+        return { filePath: null, config: { ...EMPTY_CONFIG }, issues: [] };
+    try {
+        const raw = await importConfigModule(filePath);
+        const result = validateConfig(raw);
+        return { ...result, filePath };
+    }
+    catch (error) {
+        return {
+            filePath,
+            config: { ...EMPTY_CONFIG },
+            issues: [`Failed to load ${filePath}: ${errorMessage(error)}`],
+        };
+    }
+}
+async function importConfigModule(filePath) {
+    if (filePath.endsWith(".json")) {
+        const { readFile } = await import("node:fs/promises");
+        return JSON.parse(await readFile(filePath, "utf8"));
+    }
+    const { createJiti } = await import("jiti");
+    const jiti = createJiti(import.meta.url, { interopDefault: true, moduleCache: false });
+    const loaded = await jiti.import(filePath);
+    return unwrapDefault(loaded);
+}
+function unwrapDefault(value) {
+    const record = asRecord(value);
+    if (record && "default" in record)
+        return unwrapDefault(record.default);
+    return value;
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function asArray(value, field, issues) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        issues.push(`"${field}" must be an array`);
+        return [];
+    }
+    return value;
+}
+function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const items = value.filter((item) => typeof item === "string");
+    return items.length > 0 ? items : undefined;
+}
+function asStringRecord(value) {
+    const record = asRecord(value);
+    if (!record)
+        return undefined;
+    const entries = Object.entries(record).filter((entry) => typeof entry[1] === "string");
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+function asPositiveInt(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : undefined;
+}
+/**
+ * Normalise a readiness block. `port` alone or `logPattern` alone is enough;
+ * a block with neither is dropped with an issue rather than silently waiting
+ * for nothing.
+ */
+function asReadiness(value, processId, issues) {
+    if (value === undefined)
+        return undefined;
+    const record = asRecord(value);
+    if (!record) {
+        issues.push(`processes "${processId}": readiness must be an object`);
+        return undefined;
+    }
+    const port = asPositiveInt(record.port);
+    const logPattern = asString(record.logPattern);
+    if (port === undefined && logPattern === undefined) {
+        issues.push(`processes "${processId}": readiness needs a "port" or a "logPattern"`);
+        return undefined;
+    }
+    if (logPattern !== undefined) {
+        try {
+            new RegExp(logPattern, "iu");
+        }
+        catch {
+            issues.push(`processes "${processId}": readiness.logPattern is not a valid regex`);
+            return undefined;
+        }
+    }
+    return {
+        port,
+        host: asString(record.host),
+        logPattern,
+        timeoutMs: asPositiveInt(record.timeoutMs),
+        intervalMs: asPositiveInt(record.intervalMs),
+    };
+}
+function asServiceCategory(value) {
+    const categories = ["container", "database", "runtime", "ai", "web"];
+    const name = asString(value);
+    return name && categories.includes(name)
+        ? name
+        : "web";
+}
+//# sourceMappingURL=config.js.map

package/dist/devcc/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/devcc/core/config.ts"],"names":[],"mappings":"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"}

package/dist/devcc/core/events.d.ts

@@ -0,0 +1,21 @@
+import { EventEmitter } from "node:events";
+/**
+ * Typed event bus.
+ *
+ * Backend services (processes, git, docker, system) emit events; the app layer
+ * translates them into state updates; views read state. Views never call into
+ * the backends' internals directly.
+ */
+export type EventMap = Record<string, unknown[]>;
+export declare class TypedEmitter<Events extends EventMap> extends EventEmitter<Events> {
+}
+/** A disposable subscription. Calling it twice is safe. */
+export type Unsubscribe = () => void;
+/** Collects unsubscribe functions so a component can tear everything down at once. */
+export declare class Subscriptions {
+    private disposers;
+    add(unsubscribe: Unsubscribe): Unsubscribe;
+    dispose(): void;
+    get size(): number;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/devcc/core/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/devcc/core/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;AAEhD,qBAAa,YAAY,CAAC,MAAM,SAAS,QAAQ,CAAE,SAAQ,YAAY,CAAC,MAAM,CAAC;CAAG;AAElF,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAA;AAEpC,sFAAsF;AACtF,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAoB;IAErC,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW;IAK1C,OAAO,IAAI,IAAI;IAYf,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}