@cordy/electro 1.1.2 → 1.1.3

package/dist/index.d.mts

@@ -1,122 +1,6 @@
 import { BaseWindow, BaseWindowConstructorOptions, WebContentsView, WebPreferences } from "electron";
 import { UserConfig } from "vite";
 
-//#region src/config/types.d.ts
-declare const RUNTIME_BRAND: unique symbol;
-declare const VIEW_BRAND: unique symbol;
-declare const CONFIG_BRAND: unique symbol;
-interface RuntimeDefinition {
-  readonly [RUNTIME_BRAND]: true;
-  readonly entry: string;
-  readonly vite?: UserConfig;
-  /** @internal Caller path captured by defineRuntime(). */
-  readonly __source: string;
-}
-interface ViewDefinition {
-  readonly [VIEW_BRAND]: true;
-  readonly name: string;
-  readonly entry: string;
-  readonly features?: readonly string[];
-  readonly vite?: UserConfig;
-  readonly preload?: string;
-  readonly webPreferences?: Record<string, unknown>;
-  /** @internal Caller path captured by defineView(). */
-  readonly __source: string;
-}
-interface ElectroConfig {
-  readonly [CONFIG_BRAND]: true;
-  readonly runtime: RuntimeDefinition;
-  readonly views?: readonly ViewDefinition[];
-}
-interface DefineRuntimeInput {
-  entry: string;
-  vite?: UserConfig;
-}
-interface DefineViewInput {
-  name: string;
-  entry: string;
-  features?: readonly string[];
-  vite?: UserConfig;
-  preload?: string;
-  webPreferences?: Record<string, unknown>;
-}
-interface DefineConfigInput {
-  runtime: RuntimeDefinition;
-  views?: readonly ViewDefinition[];
-}
-//#endregion
-//#region src/config/define-config.d.ts
-declare function defineConfig(input: DefineConfigInput): ElectroConfig;
-//#endregion
-//#region src/config/define-runtime.d.ts
-declare function defineRuntime(input: DefineRuntimeInput): RuntimeDefinition;
-//#endregion
-//#region src/config/define-view.d.ts
-declare function defineView(input: DefineViewInput): ViewDefinition;
-//#endregion
-//#region src/core/event-bus/types.d.ts
-type EventHandler = (payload: unknown) => void;
-type EventSubscription = {
-  channel: string;
-  handler: EventHandler;
-  ownerId: string;
-};
-type EventId = string;
-/**
-* Type-erased event interface for heterogeneous collections.
-*/
-interface EventInstance {
-  readonly id: EventId;
-  readonly defaults: unknown;
-}
-/**
-* Public interface returned by {@link createEvent}.
-*
-* Generic parameter preserves payload type for codegen inference
-* (`_EventPayload<T>` infers `T` from `payload()` phantom method).
-*/
-interface CreatedEvent<T = void> extends EventInstance {
-  readonly id: EventId;
-  readonly defaults: T | undefined;
-  /** @internal Phantom method for codegen type extraction. Never called. */
-  payload(): T;
-}
-//#endregion
-//#region src/core/event-bus/event-bus.d.ts
-declare class EventBus {
-  private readonly subscriptions;
-  publish(channel: string, payload?: unknown): void;
-  subscribe(channel: string, handler: EventHandler, ownerId: string): () => void;
-  removeByOwner(ownerId: string): void;
-}
-//#endregion
-//#region src/core/event-bus/accessor.d.ts
-/**
-* Scoped event access per feature.
-*
-* - `publish("name", payload)` -> publishes as `"ownerId:name"`
-* - `on("dep:name", handler)` -> validates `dep` is a declared dependency
-* - `on("name", handler)` -> subscribes to own `"ownerId:name"`
-*/
-declare class EventAccessor {
-  private readonly bus;
-  private readonly ownerId;
-  private readonly declaredDeps;
-  constructor(bus: EventBus, ownerId: string, declaredDeps: Set<string>);
-  publish(event: string, payload?: unknown): void;
-  on(event: string, handler: EventHandler): () => void;
-}
-//#endregion
-//#region src/core/event-bus/helpers.d.ts
-/**
-* Creates a typed event definition.
-*
-* @overload Explicit generic — `createEvent<{ version: string }>("ready")`
-* @overload Infer from defaults — `createEvent("ready", { version: "unknown" })`
-*/
-declare function createEvent<T = void>(id: EventId): CreatedEvent<T>;
-declare function createEvent<T>(id: EventId, defaults: T): CreatedEvent<T>;
-//#endregion
 //#region src/core/feature/enums.d.ts
 declare enum FeatureStatus {
   NONE = "none",
@@ -224,225 +108,40 @@ declare class WindowManager {
   destroyAll(): void;
 }
 //#endregion
-//#region src/core/task/enums.d.ts
-declare enum TaskOverlapStrategy {
-  Skip = "skip",
-  Queue = "queue",
-  Parallel = "parallel"
-}
-declare enum TaskStatus {
-  Registered = "registered",
-  Scheduled = "scheduled",
-  Running = "running",
-  Stopped = "stopped",
-  Failed = "failed"
-}
-declare enum TaskRetryStrategy {
-  Fixed = "fixed",
-  Exponential = "exponential"
-}
-//#endregion
-//#region src/core/task/types.d.ts
-type TaskId = string;
-type StopMode = "graceful" | "force";
-type TaskRetryConfig = {
-  attempts: number;
-  strategy: TaskRetryStrategy;
-  delayMs: number;
-};
-type TaskExecutionContext = {
-  signal: AbortSignal;
-  attempt: number;
-};
-type TaskConfig<TId extends TaskId, TPayload = void> = {
-  id: TId;
-  cron?: string;
-  autoStart?: boolean;
-  overlap?: TaskOverlapStrategy;
-  dedupeKey?: (payload: TPayload) => string;
-  timeoutMs?: number;
-  retry?: TaskRetryConfig;
-  execute: (ctx: FeatureContext<_TaskOwner<TId>, never, TId>, payload: TPayload, execCtx: TaskExecutionContext) => void | Promise<void>;
+//#region src/core/event-bus/types.d.ts
+type EventHandler = (payload: unknown) => void;
+type EventSubscription = {
+  channel: string;
+  handler: EventHandler;
+  ownerId: string;
 };
+type EventId = string;
 /**
-* Type-erased task interface for heterogeneous collections.
-*
-* Using a non-generic interface (instead of `Task<TaskId, unknown>`)
-* avoids TypeScript variance issues: `TaskConfig.execute` has `payload: TPayload`
-* in a contravariant position, making `Task` invariant in `TPayload`.
-* Interface methods are bivariant, so any `Task<TId, TPayload>` is
-* structurally assignable to `TaskInstance`.
-*/
-interface TaskInstance {
-  readonly id: TaskId;
-  enable(ctx: FeatureContext<any>): void;
-  disable(mode?: StopMode): void;
-  start(payload?: unknown): Promise<void>;
-  queue(payload: unknown): void;
-  stop(): void;
-  clear(): void;
-  status(): TaskStatusInfo;
-}
-interface TaskStatusInfo {
-  taskId: string;
-  state: TaskStatus;
-  running: boolean;
-  queueSize: number;
-  lastRunAt: number | null;
-  lastSuccessAt: number | null;
-  lastErrorAt: number | null;
-  lastError: Error | null;
-}
-/**
-* Public interface returned by {@link createTask}.
-*
-* Hides class internals (private fields) so consumers can safely
-* `export const myTask = createTask({...})` without TypeScript
-* "cannot be named" errors in declaration emit.
-*
-* Generic parameters preserve payload type for codegen inference
-* (`_TaskPayload<T>` infers `TPayload` from `start(payload?)`).
+* Type-erased event interface for heterogeneous collections.
 */
-interface CreatedTask<TId extends TaskId = TaskId, TPayload = void> {
-  readonly id: TId;
-  enable(ctx: FeatureContext<any>): void;
-  disable(mode?: StopMode): void;
-  start(payload?: TPayload): Promise<void>;
-  queue(payload: TPayload): void;
-  stop(): void;
-  clear(): void;
-  status(): TaskStatusInfo;
+interface EventInstance {
+  readonly id: EventId;
+  readonly defaults: unknown;
 }
-//#endregion
-//#region src/core/task/handle.d.ts
 /**
-* Ergonomic handle for a single {@link Task}.
+* Public interface returned by {@link createEvent}.
 *
-* Provides per-task control: start, queue, stop, enable, disable, clear, status.
-* Created by Feature and bound to `ctx.getTask(name)`.
+* Generic parameter preserves payload type for codegen inference
+* (`_EventPayload<T>` infers `T` from `payload()` phantom method).
 */
-declare class TaskHandle<TPayload = unknown> {
-  private readonly task;
-  private readonly ctx;
-  constructor(task: TaskInstance, ctx?: FeatureContext<any> | undefined);
-  /** Execute immediately (respects overlap policy). */
-  start(payload?: TPayload): Promise<void>;
-  /** Push payload to FIFO queue, processes sequentially. */
-  queue(payload: TPayload): void;
-  /** Abort current execution. Queue continues processing. */
-  stop(): void;
-  /** Re-enable the task (cron, ready for start/queue). */
-  enable(): void;
-  /** Abort current + clear queue + stop cron. */
-  disable(mode?: StopMode): void;
-  /** Clear the FIFO queue without stopping current execution. */
-  clear(): void;
-  /** Snapshot of the task's current state. */
-  status(): TaskStatusInfo;
+interface CreatedEvent<T = void> extends EventInstance {
+  readonly id: EventId;
+  readonly defaults: T | undefined;
+  /** @internal Phantom method for codegen type extraction. Never called. */
+  payload(): T;
 }
 //#endregion
-//#region src/core/types.d.ts
-/**
-* Declaration-merging registry.
-* Codegen populates this via `declare module "@cordy/electro"`.
-*
-* Each key is a feature ID mapping to its services, tasks, and dependencies.
-*/
-interface FeatureMap {}
-/** Maps service ID → owning feature ID. Populated by codegen. */
-interface ServiceOwnerMap {}
-/** Maps task ID → owning feature ID. Populated by codegen. */
-interface TaskOwnerMap {}
-/** Declaration-merging registry for view types. Codegen populates this. */
-interface ViewMap {}
-/** Declaration-merging registry for window API types. Codegen populates this. */
-interface WindowApiMap {}
-/** Resolve the owning feature ID for a service. Falls back to `string` (→ BaseContext). */
-type _ServiceOwner<TId extends string> = TId extends keyof ServiceOwnerMap ? ServiceOwnerMap[TId] : string;
-/** Resolve the owning feature ID for a task. Falls back to `string` (→ BaseContext). */
-type _TaskOwner<TId extends string> = TId extends keyof TaskOwnerMap ? TaskOwnerMap[TId] : string;
-type _SuggestViewKeys = (keyof ViewMap & string) | (string & {});
-type _SuggestWindowKeys = (keyof WindowApiMap & string) | (string & {});
-type _ResolveWindowApi<K extends string> = K extends keyof WindowApiMap ? WindowApiMap[K] : unknown;
-/** Extract the dependency IDs union for a feature. */
-type _DepIds<FId> = FId extends keyof FeatureMap ? FeatureMap[FId]["dependencies"] : never;
-/** Own service keys for a feature. */
-type _OwnSvcKeys<FId> = FId extends keyof FeatureMap ? keyof FeatureMap[FId]["services"] & string : never;
-/** Distributive helper — maps a single dep ID to its qualified service keys. */
-type _DepSvcOf<D> = D extends keyof FeatureMap & string ? `${D}:${keyof FeatureMap[D]["services"] & string}` : never;
-/** Qualified dependency service keys ("dep:svc"), distributes over the deps union. */
-type _DepSvcKeys<FId> = _DepSvcOf<_DepIds<FId>>;
-/** Resolve a service type from own or dependency services. */
-type _ResolveSvc<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["services"] ? FeatureMap[FId]["services"][K] : K extends `${infer D}:${infer S}` ? D extends _DepIds<FId> & keyof FeatureMap ? S extends keyof FeatureMap[D]["services"] ? FeatureMap[D]["services"][S] : unknown : unknown : unknown : unknown;
-/** Resolve a task type from own tasks. FeatureMap stores payloads; wraps in TaskHandle. */
-type _ResolveTask<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["tasks"] ? TaskHandle<FeatureMap[FId]["tasks"][K]> : unknown : unknown;
-/** Resolve a feature handle from dependency features. */
-type _ResolveFeature<FId, K extends string> = FId extends keyof FeatureMap ? K extends _DepIds<FId> & string ? FeatureHandle : unknown : unknown;
-type _SuggestSvcKeys<FId> = _OwnSvcKeys<FId> | _DepSvcKeys<FId>;
-type _SuggestTaskKeys<FId> = FId extends keyof FeatureMap ? keyof FeatureMap[FId]["tasks"] & string : never;
-type _SuggestDepKeys<FId> = _DepIds<FId> & string;
-/** Own event keys for a feature. */
-type _OwnEventKeys<FId> = FId extends keyof FeatureMap ? keyof FeatureMap[FId]["events"] & string : never;
-/** Distributive helper — maps a single dep ID to its qualified event keys. */
-type _DepEventOf<D> = D extends keyof FeatureMap & string ? `${D}:${keyof FeatureMap[D]["events"] & string}` : never;
-/** Qualified dependency event keys ("dep:event"), distributes over the deps union. */
-type _DepEventKeys<FId> = _DepEventOf<_DepIds<FId>>;
-/** Resolve own event payload. */
-type _ResolveOwnEvent<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["events"] ? FeatureMap[FId]["events"][K] : unknown : unknown;
-/** Resolve any event payload (own or dep). */
-type _ResolveEvent<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["events"] ? FeatureMap[FId]["events"][K] : K extends `${infer D}:${infer E}` ? D extends _DepIds<FId> & keyof FeatureMap ? E extends keyof FeatureMap[D]["events"] ? FeatureMap[D]["events"][E] : unknown : unknown : unknown : unknown;
-/** All service keys across all features (mapped type distributes over each feature). */
-type _AllSvcKeys = { [F in keyof FeatureMap]: keyof FeatureMap[F]["services"] & string }[keyof FeatureMap];
-/** All task keys across all features (mapped type distributes over each feature). */
-type _AllTaskKeys = { [F in keyof FeatureMap]: keyof FeatureMap[F]["tasks"] & string }[keyof FeatureMap];
-/** All feature IDs. */
-type _AllFeatureIds = keyof FeatureMap & string;
-/** All event keys across all features. */
-type _AllEventKeys = { [F in keyof FeatureMap]: keyof FeatureMap[F]["events"] & string }[keyof FeatureMap];
-type _SuggestAllSvc = _AllSvcKeys | (string & {});
-type _SuggestAllTask = _AllTaskKeys | (string & {});
-type _SuggestAllFeature = _AllFeatureIds | (string & {});
-type _SuggestAllEvent = _AllEventKeys | (string & {});
-/** Flat resolve for unscoped service lookup. */
-type _FlatResolveSvc<K extends string> = { [F in keyof FeatureMap]: K extends keyof FeatureMap[F]["services"] ? FeatureMap[F]["services"][K] : never }[keyof FeatureMap] extends infer U ? [U] extends [never] ? unknown : U : unknown;
-/** Flat resolve for unscoped task lookup. FeatureMap stores payloads; wraps in TaskHandle. */
-type _FlatResolveTask<K extends string> = { [F in keyof FeatureMap]: K extends keyof FeatureMap[F]["tasks"] ? TaskHandle<FeatureMap[F]["tasks"][K]> : never }[keyof FeatureMap] extends infer U ? [U] extends [never] ? unknown : U : unknown;
-/** Flat resolve for unscoped feature lookup. */
-type _FlatResolveFeature<K extends string> = K extends keyof FeatureMap ? FeatureHandle : unknown;
-/** Scoped context — used when `FId` is a concrete feature key. */
-type TypedContext<FId extends keyof FeatureMap, ExcludeSvc extends string = never, ExcludeTask extends string = never> = {
-  signal: AbortSignal;
-  logger: LoggerContext;
-  getService: <K extends Exclude<_SuggestSvcKeys<FId>, ExcludeSvc>>(name: K) => _ResolveSvc<FId, K & string>;
-  getTask: <K extends Exclude<_SuggestTaskKeys<FId>, ExcludeTask>>(name: K) => _ResolveTask<FId, K & string>;
-  getFeature: <K extends _SuggestDepKeys<FId>>(name: K) => _ResolveFeature<FId, K & string>;
-  events: {
-    publish<K extends _OwnEventKeys<FId>>(event: K, ...args: undefined extends _ResolveOwnEvent<FId, K> ? [payload?: _ResolveOwnEvent<FId, K>] : [payload: _ResolveOwnEvent<FId, K>]): void;
-    on<K extends _OwnEventKeys<FId> | _DepEventKeys<FId>>(event: K, handler: (payload: _ResolveEvent<FId, K>) => void): () => void;
-  };
-  getWindow: <K extends _SuggestWindowKeys>(id: K) => CreatedWindow<_ResolveWindowApi<K & string>> | null;
-  createView: <K extends _SuggestViewKeys>(id: K) => ElectroView;
-  getView: <K extends _SuggestViewKeys>(id: K) => ElectroView | null;
-};
-/** Unscoped context — flat suggestions from all features. */
-type BaseContext = {
-  signal: AbortSignal;
-  logger: LoggerContext;
-  getService: <K extends _SuggestAllSvc>(name: K) => _FlatResolveSvc<K & string>;
-  getTask: <K extends _SuggestAllTask>(name: K) => _FlatResolveTask<K & string>;
-  getFeature: <K extends _SuggestAllFeature>(name: K) => _FlatResolveFeature<K & string>;
-  events: {
-    publish(event: _SuggestAllEvent, payload?: unknown): void;
-    on(event: string, handler: (payload: unknown) => void): () => void;
-  };
-  getWindow: <K extends _SuggestWindowKeys>(id: K) => CreatedWindow<_ResolveWindowApi<K & string>> | null;
-  createView: <K extends _SuggestViewKeys>(id: K) => ElectroView;
-  getView: <K extends _SuggestViewKeys>(id: K) => ElectroView | null;
-};
-interface LoggerContext {
-  debug(code: string, message: string, details?: Record<string, unknown>): void;
-  warn(code: string, message: string, details?: Record<string, unknown>): void;
-  error(code: string, message: string, details?: Record<string, unknown>): void;
+//#region src/core/event-bus/event-bus.d.ts
+declare class EventBus {
+  private readonly subscriptions;
+  publish(channel: string, payload?: unknown): void;
+  subscribe(channel: string, handler: EventHandler, ownerId: string): () => void;
+  removeByOwner(ownerId: string): void;
 }
 //#endregion
 //#region src/core/service/enums.d.ts
@@ -484,22 +183,112 @@ interface ServiceInstance {
   status(): ServiceInfo;
 }
 /**
-* Public interface returned by {@link createService}.
+* Public interface returned by {@link createService}.
+*
+* Hides class internals so consumers can safely
+* `export const myService = createService({...})` without TypeScript
+* "cannot be named" errors in declaration emit.
+*
+* Generic parameters preserve scope + API types for codegen inference
+* (`_SvcApi<T>` infers from `api()`).
+*/
+interface CreatedService<Scope extends ServiceScope = ServiceScope, TApi = unknown> {
+  readonly id: ServiceId;
+  readonly scope: Scope;
+  build(ctx: FeatureContext<any>): void;
+  destroy(): void;
+  api(): TApi | null;
+  status(): ServiceInfo;
+}
+//#endregion
+//#region src/core/task/enums.d.ts
+declare enum TaskOverlapStrategy {
+  Skip = "skip",
+  Queue = "queue",
+  Parallel = "parallel"
+}
+declare enum TaskStatus {
+  Registered = "registered",
+  Scheduled = "scheduled",
+  Running = "running",
+  Stopped = "stopped",
+  Failed = "failed"
+}
+declare enum TaskRetryStrategy {
+  Fixed = "fixed",
+  Exponential = "exponential"
+}
+//#endregion
+//#region src/core/task/types.d.ts
+type TaskId = string;
+type StopMode = "graceful" | "force";
+type TaskRetryConfig = {
+  attempts: number;
+  strategy: TaskRetryStrategy;
+  delayMs: number;
+};
+type TaskExecutionContext = {
+  signal: AbortSignal;
+  attempt: number;
+};
+type TaskConfig<TId extends TaskId, TPayload = void> = {
+  id: TId;
+  cron?: string;
+  autoStart?: boolean;
+  overlap?: TaskOverlapStrategy;
+  dedupeKey?: (payload: TPayload) => string;
+  timeoutMs?: number;
+  retry?: TaskRetryConfig;
+  execute: (ctx: FeatureContext<_TaskOwner<TId>, never, TId>, payload: TPayload, execCtx: TaskExecutionContext) => void | Promise<void>;
+};
+/**
+* Type-erased task interface for heterogeneous collections.
+*
+* Using a non-generic interface (instead of `Task<TaskId, unknown>`)
+* avoids TypeScript variance issues: `TaskConfig.execute` has `payload: TPayload`
+* in a contravariant position, making `Task` invariant in `TPayload`.
+* Interface methods are bivariant, so any `Task<TId, TPayload>` is
+* structurally assignable to `TaskInstance`.
+*/
+interface TaskInstance {
+  readonly id: TaskId;
+  enable(ctx: FeatureContext<any>): void;
+  disable(mode?: StopMode): void;
+  start(payload?: unknown): Promise<void>;
+  queue(payload: unknown): void;
+  stop(): void;
+  clear(): void;
+  status(): TaskStatusInfo;
+}
+interface TaskStatusInfo {
+  taskId: string;
+  state: TaskStatus;
+  running: boolean;
+  queueSize: number;
+  lastRunAt: number | null;
+  lastSuccessAt: number | null;
+  lastErrorAt: number | null;
+  lastError: Error | null;
+}
+/**
+* Public interface returned by {@link createTask}.
 *
-* Hides class internals so consumers can safely
-* `export const myService = createService({...})` without TypeScript
+* Hides class internals (private fields) so consumers can safely
+* `export const myTask = createTask({...})` without TypeScript
 * "cannot be named" errors in declaration emit.
 *
-* Generic parameters preserve scope + API types for codegen inference
-* (`_SvcApi<T>` infers from `api()`).
+* Generic parameters preserve payload type for codegen inference
+* (`_TaskPayload<T>` infers `TPayload` from `start(payload?)`).
 */
-interface CreatedService<Scope extends ServiceScope = ServiceScope, TApi = unknown> {
-  readonly id: ServiceId;
-  readonly scope: Scope;
-  build(ctx: FeatureContext<any>): void;
-  destroy(): void;
-  api(): TApi | null;
-  status(): ServiceInfo;
+interface CreatedTask<TId extends TaskId = TaskId, TPayload = void> {
+  readonly id: TId;
+  enable(ctx: FeatureContext<any>): void;
+  disable(mode?: StopMode): void;
+  start(payload?: TPayload): Promise<void>;
+  queue(payload: TPayload): void;
+  stop(): void;
+  clear(): void;
+  status(): TaskStatusInfo;
 }
 //#endregion
 //#region src/core/feature/types.d.ts
@@ -697,6 +486,219 @@ declare class FeatureHandle {
   disable(): Promise<void>;
 }
 //#endregion
+//#region src/core/task/handle.d.ts
+/**
+* Ergonomic handle for a single {@link Task}.
+*
+* Provides per-task control: start, queue, stop, enable, disable, clear, status.
+* Created by Feature and bound to `ctx.getTask(name)`.
+*/
+declare class TaskHandle<TPayload = unknown> {
+  private readonly task;
+  private readonly ctx;
+  constructor(task: TaskInstance, ctx?: FeatureContext<any> | undefined);
+  /** Execute immediately (respects overlap policy). */
+  start(payload?: TPayload): Promise<void>;
+  /** Push payload to FIFO queue, processes sequentially. */
+  queue(payload: TPayload): void;
+  /** Abort current execution. Queue continues processing. */
+  stop(): void;
+  /** Re-enable the task (cron, ready for start/queue). */
+  enable(): void;
+  /** Abort current + clear queue + stop cron. */
+  disable(mode?: StopMode): void;
+  /** Clear the FIFO queue without stopping current execution. */
+  clear(): void;
+  /** Snapshot of the task's current state. */
+  status(): TaskStatusInfo;
+}
+//#endregion
+//#region src/core/types.d.ts
+/**
+* Declaration-merging registry.
+* Codegen populates this via `declare module "@cordy/electro"`.
+*
+* Each key is a feature ID mapping to its services, tasks, and dependencies.
+*/
+interface FeatureMap {}
+/** Maps service ID → owning feature ID. Populated by codegen. */
+interface ServiceOwnerMap {}
+/** Maps task ID → owning feature ID. Populated by codegen. */
+interface TaskOwnerMap {}
+/** Declaration-merging registry for view types. Codegen populates this. */
+interface ViewMap {}
+/** Declaration-merging registry for window API types. Codegen populates this. */
+interface WindowApiMap {}
+/** Resolve the owning feature ID for a service. Falls back to `string` (→ BaseContext). */
+type _ServiceOwner<TId extends string> = TId extends keyof ServiceOwnerMap ? ServiceOwnerMap[TId] : string;
+/** Resolve the owning feature ID for a task. Falls back to `string` (→ BaseContext). */
+type _TaskOwner<TId extends string> = TId extends keyof TaskOwnerMap ? TaskOwnerMap[TId] : string;
+type _SuggestViewKeys = (keyof ViewMap & string) | (string & {});
+type _SuggestWindowKeys = (keyof WindowApiMap & string) | (string & {});
+type _ResolveWindowApi<K extends string> = K extends keyof WindowApiMap ? WindowApiMap[K] : unknown;
+/** Extract the dependency IDs union for a feature. */
+type _DepIds<FId> = FId extends keyof FeatureMap ? FeatureMap[FId]["dependencies"] : never;
+/** Own service keys for a feature. */
+type _OwnSvcKeys<FId> = FId extends keyof FeatureMap ? keyof FeatureMap[FId]["services"] & string : never;
+/** Distributive helper — maps a single dep ID to its qualified service keys. */
+type _DepSvcOf<D> = D extends keyof FeatureMap & string ? `${D}:${keyof FeatureMap[D]["services"] & string}` : never;
+/** Qualified dependency service keys ("dep:svc"), distributes over the deps union. */
+type _DepSvcKeys<FId> = _DepSvcOf<_DepIds<FId>>;
+/** Resolve a service type from own or dependency services. */
+type _ResolveSvc<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["services"] ? FeatureMap[FId]["services"][K] : K extends `${infer D}:${infer S}` ? D extends _DepIds<FId> & keyof FeatureMap ? S extends keyof FeatureMap[D]["services"] ? FeatureMap[D]["services"][S] : unknown : unknown : unknown : unknown;
+/** Resolve a task type from own tasks. FeatureMap stores payloads; wraps in TaskHandle. */
+type _ResolveTask<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["tasks"] ? TaskHandle<FeatureMap[FId]["tasks"][K]> : unknown : unknown;
+/** Resolve a feature handle from dependency features. */
+type _ResolveFeature<FId, K extends string> = FId extends keyof FeatureMap ? K extends _DepIds<FId> & string ? FeatureHandle : unknown : unknown;
+type _SuggestSvcKeys<FId> = _OwnSvcKeys<FId> | _DepSvcKeys<FId>;
+type _SuggestTaskKeys<FId> = FId extends keyof FeatureMap ? keyof FeatureMap[FId]["tasks"] & string : never;
+type _SuggestDepKeys<FId> = _DepIds<FId> & string;
+/** Own event keys for a feature. */
+type _OwnEventKeys<FId> = FId extends keyof FeatureMap ? keyof FeatureMap[FId]["events"] & string : never;
+/** Distributive helper — maps a single dep ID to its qualified event keys. */
+type _DepEventOf<D> = D extends keyof FeatureMap & string ? `${D}:${keyof FeatureMap[D]["events"] & string}` : never;
+/** Qualified dependency event keys ("dep:event"), distributes over the deps union. */
+type _DepEventKeys<FId> = _DepEventOf<_DepIds<FId>>;
+/** Resolve own event payload. */
+type _ResolveOwnEvent<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["events"] ? FeatureMap[FId]["events"][K] : unknown : unknown;
+/** Resolve any event payload (own or dep). */
+type _ResolveEvent<FId, K extends string> = FId extends keyof FeatureMap ? K extends keyof FeatureMap[FId]["events"] ? FeatureMap[FId]["events"][K] : K extends `${infer D}:${infer E}` ? D extends _DepIds<FId> & keyof FeatureMap ? E extends keyof FeatureMap[D]["events"] ? FeatureMap[D]["events"][E] : unknown : unknown : unknown : unknown;
+/** All service keys across all features (mapped type distributes over each feature). */
+type _AllSvcKeys = { [F in keyof FeatureMap]: keyof FeatureMap[F]["services"] & string }[keyof FeatureMap];
+/** All task keys across all features (mapped type distributes over each feature). */
+type _AllTaskKeys = { [F in keyof FeatureMap]: keyof FeatureMap[F]["tasks"] & string }[keyof FeatureMap];
+/** All feature IDs. */
+type _AllFeatureIds = keyof FeatureMap & string;
+/** All event keys across all features. */
+type _AllEventKeys = { [F in keyof FeatureMap]: keyof FeatureMap[F]["events"] & string }[keyof FeatureMap];
+type _SuggestAllSvc = _AllSvcKeys | (string & {});
+type _SuggestAllTask = _AllTaskKeys | (string & {});
+type _SuggestAllFeature = _AllFeatureIds | (string & {});
+type _SuggestAllEvent = _AllEventKeys | (string & {});
+/** Flat resolve for unscoped service lookup. */
+type _FlatResolveSvc<K extends string> = { [F in keyof FeatureMap]: K extends keyof FeatureMap[F]["services"] ? FeatureMap[F]["services"][K] : never }[keyof FeatureMap] extends infer U ? [U] extends [never] ? unknown : U : unknown;
+/** Flat resolve for unscoped task lookup. FeatureMap stores payloads; wraps in TaskHandle. */
+type _FlatResolveTask<K extends string> = { [F in keyof FeatureMap]: K extends keyof FeatureMap[F]["tasks"] ? TaskHandle<FeatureMap[F]["tasks"][K]> : never }[keyof FeatureMap] extends infer U ? [U] extends [never] ? unknown : U : unknown;
+/** Flat resolve for unscoped feature lookup. */
+type _FlatResolveFeature<K extends string> = K extends keyof FeatureMap ? FeatureHandle : unknown;
+/** Scoped context — used when `FId` is a concrete feature key. */
+type TypedContext<FId extends keyof FeatureMap, ExcludeSvc extends string = never, ExcludeTask extends string = never> = {
+  signal: AbortSignal;
+  logger: LoggerContext;
+  getService: <K extends Exclude<_SuggestSvcKeys<FId>, ExcludeSvc>>(name: K) => _ResolveSvc<FId, K & string>;
+  getTask: <K extends Exclude<_SuggestTaskKeys<FId>, ExcludeTask>>(name: K) => _ResolveTask<FId, K & string>;
+  getFeature: <K extends _SuggestDepKeys<FId>>(name: K) => _ResolveFeature<FId, K & string>;
+  events: {
+    publish<K extends _OwnEventKeys<FId>>(event: K, ...args: undefined extends _ResolveOwnEvent<FId, K> ? [payload?: _ResolveOwnEvent<FId, K>] : [payload: _ResolveOwnEvent<FId, K>]): void;
+    on<K extends _OwnEventKeys<FId> | _DepEventKeys<FId>>(event: K, handler: (payload: _ResolveEvent<FId, K>) => void): () => void;
+  };
+  getWindow: <K extends _SuggestWindowKeys>(id: K) => CreatedWindow<_ResolveWindowApi<K & string>> | null;
+  createView: <K extends _SuggestViewKeys>(id: K) => ElectroView;
+  getView: <K extends _SuggestViewKeys>(id: K) => ElectroView | null;
+};
+/** Unscoped context — flat suggestions from all features. */
+type BaseContext = {
+  signal: AbortSignal;
+  logger: LoggerContext;
+  getService: <K extends _SuggestAllSvc>(name: K) => _FlatResolveSvc<K & string>;
+  getTask: <K extends _SuggestAllTask>(name: K) => _FlatResolveTask<K & string>;
+  getFeature: <K extends _SuggestAllFeature>(name: K) => _FlatResolveFeature<K & string>;
+  events: {
+    publish(event: _SuggestAllEvent, payload?: unknown): void;
+    on(event: string, handler: (payload: unknown) => void): () => void;
+  };
+  getWindow: <K extends _SuggestWindowKeys>(id: K) => CreatedWindow<_ResolveWindowApi<K & string>> | null;
+  createView: <K extends _SuggestViewKeys>(id: K) => ElectroView;
+  getView: <K extends _SuggestViewKeys>(id: K) => ElectroView | null;
+};
+interface LoggerContext {
+  debug(code: string, message: string, details?: Record<string, unknown>): void;
+  warn(code: string, message: string, details?: Record<string, unknown>): void;
+  error(code: string, message: string, details?: Record<string, unknown>): void;
+}
+//#endregion
+//#region src/config/types.d.ts
+declare const RUNTIME_BRAND: unique symbol;
+declare const VIEW_BRAND: unique symbol;
+declare const CONFIG_BRAND: unique symbol;
+interface RuntimeDefinition {
+  readonly [RUNTIME_BRAND]: true;
+  readonly entry: string;
+  readonly vite?: UserConfig;
+  /** @internal Caller path captured by defineRuntime(). */
+  readonly __source: string;
+}
+interface ViewDefinition {
+  readonly [VIEW_BRAND]: true;
+  readonly name: string;
+  readonly entry: string;
+  readonly features?: readonly string[];
+  readonly vite?: UserConfig;
+  readonly preload?: string;
+  readonly webPreferences?: Record<string, unknown>;
+  /** @internal Caller path captured by defineView(). */
+  readonly __source: string;
+}
+interface ElectroConfig {
+  readonly [CONFIG_BRAND]: true;
+  readonly runtime: RuntimeDefinition;
+  readonly views?: readonly ViewDefinition[];
+}
+interface DefineRuntimeInput {
+  entry: string;
+  vite?: UserConfig;
+}
+/** Suggests known feature IDs from FeatureMap while still allowing arbitrary strings. */
+type SuggestFeatureId = (keyof FeatureMap & string) | (string & {});
+interface DefineViewInput {
+  name: string;
+  entry: string;
+  features?: readonly SuggestFeatureId[];
+  vite?: UserConfig;
+  preload?: string;
+  webPreferences?: Record<string, unknown>;
+}
+interface DefineConfigInput {
+  runtime: RuntimeDefinition;
+  views?: readonly ViewDefinition[];
+}
+//#endregion
+//#region src/config/define-config.d.ts
+declare function defineConfig(input: DefineConfigInput): ElectroConfig;
+//#endregion
+//#region src/config/define-runtime.d.ts
+declare function defineRuntime(input: DefineRuntimeInput): RuntimeDefinition;
+//#endregion
+//#region src/config/define-view.d.ts
+declare function defineView(input: DefineViewInput): ViewDefinition;
+//#endregion
+//#region src/core/event-bus/accessor.d.ts
+/**
+* Scoped event access per feature.
+*
+* - `publish("name", payload)` -> publishes as `"ownerId:name"`
+* - `on("dep:name", handler)` -> validates `dep` is a declared dependency
+* - `on("name", handler)` -> subscribes to own `"ownerId:name"`
+*/
+declare class EventAccessor {
+  private readonly bus;
+  private readonly ownerId;
+  private readonly declaredDeps;
+  constructor(bus: EventBus, ownerId: string, declaredDeps: Set<string>);
+  publish(event: string, payload?: unknown): void;
+  on(event: string, handler: EventHandler): () => void;
+}
+//#endregion
+//#region src/core/event-bus/helpers.d.ts
+/**
+* Creates a typed event definition.
+*
+* @overload Explicit generic — `createEvent<{ version: string }>("ready")`
+* @overload Infer from defaults — `createEvent("ready", { version: "unknown" })`
+*/
+declare function createEvent<T = void>(id: EventId): CreatedEvent<T>;
+declare function createEvent<T>(id: EventId, defaults: T): CreatedEvent<T>;
+//#endregion
 //#region src/core/feature/helpers.d.ts
 /**
 * Method for creating a feature

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cordy/electro",
-    "version": "1.1.2",
+    "version": "1.1.3",
     "description": "Electron framework — feature-first runtime, codegen, and Vite-based build system",
     "license": "MIT",
     "type": "module",