@electrojs/codegen 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anton Ryuben
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# @electrojs/codegen
+
+Code generator for Electro's module runtime — scans decorator metadata from source and emits preload scripts, runtime registry, and environment type declarations.
+
+`@electrojs/codegen` provides the `scan` → `generate` pipeline that powers `electro generate` and runs automatically during `electro dev` and `electro build`. It uses the OXC parser to extract `@Module`, `@Injectable`, `@Window`, `@View`, `@command`, `@query`, `@signal`, and `@job` decorators from TypeScript source without executing it.
+
+---
+
+## Installation
+
+```bash
+pnpm add -D @electrojs/codegen
+```
+
+> Peer dependencies: `@electrojs/common`, `@electrojs/config`, `@electrojs/runtime`.
+
+---
+
+## Pipeline
+
+### 1. Scan
+
+```ts
+import { scan } from "@electrojs/codegen";
+
+const result = await scan("./src");
+```
+
+`scan()` walks the source directory, parses each `.ts` file with OXC, and extracts:
+
+- **Modules** — classes with `@Module()`, including their imports, providers, exports, windows, and views
+- **Providers** — classes with `@Injectable()`, including their decorated methods
+- **Windows** — classes with `@Window()`, with id and export status
+- **Views** — classes with `@View()`, with id, source, access keys, and signal keys
+- **Methods** — `@command()` and `@query()` decorated methods, with derived IDs
+- **Signals** — detected from `@signal()` decorators, `SignalBus.publish()`, and `SignalBus.subscribe()` calls
+- **Jobs** — `@job()` decorated methods, with optional cron expressions
+
+Files matching `*.d.ts`, `*.test.ts`, `*.spec.ts`, `*.gen.ts`, and `node_modules/` are excluded.
+
+### 2. Generate
+
+```ts
+import { generate } from "@electrojs/codegen";
+
+const output = generate({
+    scanResult: result,
+    views: [{ id: "main" }, { id: "auth" }],
+    outputDir: ".electro/generated",
+    srcDir: "./runtime",
+    packageTargets: [
+        { packageRoot: "./views/main", viewId: "main" },
+        { packageRoot: "./views/auth", viewId: "auth" },
+    ],
+});
+```
+
+`generate()` validates the scan result, then produces:
+
+| Output                    | Path                                | Description                                                                                                                     |
+| ------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| Preload scripts           | `generated/preload/{viewId}.gen.ts` | Per-view bridge client setup via `createBridgeClient()`                                                                         |
+| Runtime registry          | `generated/runtime/registry.gen.ts` | Exports scanned modules, windows, views; identifies root module and creates `electroAppDefinition`                              |
+| Runtime environment types | `runtime/electro-env.d.ts`          | Ambient registry interfaces for runtime authoring: methods, signals, jobs, injectables, windows, views, and class augmentations |
+| View environment types    | `views/*/electro-env.d.ts`          | Package-local ambient types for `@electrojs/renderer` bridge contracts and forwarded signal payloads                            |
+
+---
+
+## Validation
+
+Before generating, the pipeline runs exhaustive checks:
+
+- Duplicate module, window, or view IDs
+- Duplicate method IDs within a module (including its providers)
+- Unknown access keys — views must reference valid `module:method` pairs
+- Unknown signal keys — views must reference known signal IDs
+- Missing runtime views — every generator view definition must match a scanned `@View()` class
+
+All diagnostics are collected and thrown as a single `ValidationError` with the full array.
+
+---
+
+## ID derivation
+
+| Entity | Default ID                                              | Override                                                  |
+| ------ | ------------------------------------------------------- | --------------------------------------------------------- |
+| Module | Class name minus `Module` suffix, lowercased first char | `@Module({ id: "custom" })`                               |
+| Method | Method name                                             | `@command({ id: "custom" })` / `@query({ id: "custom" })` |
+| View   | Extracted from `source: "view:<id>"`                    | `@View({ id: "custom" })`                                 |
+| Job    | Method name                                             | `@job({ id: "custom" })`                                  |
+
+Public bridge keys follow the `module:method` pattern (e.g., `workspace:openProject`). Signal keys follow the `signalId` pattern (e.g., `projectOpened`).
+
+---
+
+## Exports
+
+```ts
+// Pipeline
+import { scan, generate } from "@electrojs/codegen";
+
+// Errors
+import { CodegenError, ValidationError } from "@electrojs/codegen";
+```
+
+Type-only imports:
+
+```ts
+import type {
+    ScanResult,
+    ScannedModule,
+    ScannedProvider,
+    ScannedMethod,
+    ScannedSignal,
+    ScannedJob,
+    ScannedWindow,
+    ScannedView,
+    GeneratorInput,
+    GeneratorOutput,
+    GeneratedFile,
+    GeneratorViewDefinition,
+    CodegenDiagnostic,
+} from "@electrojs/codegen";
+```
+
+---
+
+## Package layering
+
+```txt
+@electrojs/common        ← decorator definitions, metadata keys
+@electrojs/config        ← config schema (view definitions)
+    ↑
+@electrojs/codegen       ← this package: scanner + generator
+    ↑
+@electrojs/cli           ← invokes scan/generate during dev, build, generate commands
+```

package/dist/index.d.mts

@@ -0,0 +1,214 @@
+//#region src/types.d.ts
+/**
+ * Public type contracts for `@electrojs/codegen`.
+ *
+ * All scan result types, generator input/output types, and diagnostic types
+ * are defined here and re-exported from the package entry point.
+ *
+ * @module types
+ */
+/** Complete result of scanning a project's source files for Electro decorators. */
+interface ScanResult {
+  readonly modules: readonly ScannedModule[];
+  readonly windows: readonly ScannedWindow[];
+  readonly views: readonly ScannedView[];
+}
+/** A class decorated with `@Module()`. */
+interface ScannedModule {
+  /** Derived or explicit module ID (from `@Module({ id })` or class name). */
+  readonly id: string;
+  readonly className: string;
+  readonly filePath: string;
+  readonly exported: boolean;
+  /** Module class names referenced in `@Module({ imports })`. */
+  readonly imports: readonly string[];
+  /** `@Injectable()` providers registered in this module via `@Module({ providers })`. */
+  readonly providers: readonly ScannedProvider[];
+  /** `@command` / `@query` methods declared directly on the module class. */
+  readonly methods: readonly ScannedMethod[];
+  /** `@signal` handler methods declared directly on the module class. */
+  readonly signals: readonly ScannedSignal[];
+  /** `@job` methods declared directly on the module class. */
+  readonly jobs: readonly ScannedJob[];
+}
+/** A class decorated with `@Injectable()` that belongs to a module. */
+interface ScannedProvider {
+  readonly className: string;
+  readonly filePath: string;
+  readonly exported: boolean;
+  /** `@command` / `@query` methods declared on this provider. */
+  readonly methods: readonly ScannedMethod[];
+  /** `@signal` handler methods declared on this provider. */
+  readonly signals: readonly ScannedSignal[];
+  /** `@job` methods declared on this provider. */
+  readonly jobs: readonly ScannedJob[];
+}
+/** A method decorated with `@command()` or `@query()`. */
+interface ScannedMethod {
+  /** Method ID: from `@command({ id })` / `@query({ id })`, or the method name. */
+  readonly id: string;
+  readonly methodName: string;
+  readonly kind: "command" | "query";
+  /** Class name that owns this method. */
+  readonly ownerClassName: string;
+}
+type ScannedSignalSource = "decorator" | "publish" | "subscribe";
+type ScannedSignalPayload = {
+  readonly kind: "method-parameter";
+  readonly parameterIndex: number;
+} | {
+  readonly kind: "method-parameter-pick";
+  readonly parameterIndex: number;
+  readonly keys: readonly string[];
+} | {
+  readonly kind: "void";
+} | {
+  readonly kind: "unknown";
+};
+/** A signal observed from `@signal()`, `publish()`, or `subscribe()`. */
+interface ScannedSignal {
+  /** Signal ID observed in the runtime class. */
+  readonly id: string;
+  /** Method that declared, published, or subscribed to this signal. */
+  readonly methodName: string;
+  /** Class name that owns this signal declaration/publication/subscription. */
+  readonly ownerClassName: string;
+  /** How this signal was discovered. */
+  readonly source: ScannedSignalSource;
+  /** Best-effort payload source for bridge/env type generation. */
+  readonly payload: ScannedSignalPayload;
+}
+/** A method decorated with `@job()`. */
+interface ScannedJob {
+  /** Job ID: from `@job({ id })`, or the method name. */
+  readonly id: string;
+  readonly methodName: string;
+  /** Class name that owns this job. */
+  readonly ownerClassName: string;
+  /** Cron expression from `@job({ cron })`, or `null`. */
+  readonly cron: string | null;
+}
+/** A class decorated with `@Window()`. */
+interface ScannedWindow {
+  readonly id: string;
+  readonly className: string;
+  readonly filePath: string;
+  readonly exported: boolean;
+}
+/** A class decorated with `@View()`. */
+interface ScannedView {
+  readonly id: string;
+  readonly className: string;
+  readonly filePath: string;
+  readonly exported: boolean;
+  /** Source URL from `@View({ source })`. */
+  readonly source: string;
+  /** Bridge access keys from `@View({ access })`. */
+  readonly access: readonly string[];
+  /** Signal keys from `@View({ signals })`. */
+  readonly signals: readonly string[];
+}
+/** Target for per-package `electro-env.d.ts` generation. */
+interface PackageTypeTarget {
+  /** Absolute path to the renderer package root (dirname of `view.config.ts`). */
+  readonly packageRoot: string;
+  /** View ID that this renderer package belongs to. */
+  readonly viewId: string;
+}
+/** Input for the `generate()` function. */
+interface GeneratorInput {
+  readonly scanResult: ScanResult;
+  /** CLI-discovered view configs (for preload extension paths). */
+  readonly views?: readonly GeneratorViewDefinition[];
+  /** Directory where `generated/` folder will be placed. */
+  readonly outputDir: string;
+  /** Project source root for relative import resolution. */
+  readonly srcDir: string;
+  /** Targets for per-package `electro-env.d.ts` generation. */
+  readonly packageTargets?: readonly PackageTypeTarget[];
+}
+/** A view definition provided by the CLI (not from AST scanning). */
+interface GeneratorViewDefinition {
+  readonly id: string;
+  /** Path to the user's preload extension script, or `null`/`undefined`. */
+  readonly preload?: string | null;
+  /** Original file path for relative import resolution. */
+  readonly __source: string;
+}
+/** A generated package-local `electro-env.d.ts` file. */
+interface PackageTypeOutput {
+  /** Absolute path to the package root. */
+  readonly packageRoot: string;
+  /** Relative output path inside the package root. */
+  readonly path: string;
+  /** Content of the generated declaration file. */
+  readonly content: string;
+  /** Backward-compatible alias for the generated declaration content. */
+  readonly indexDts?: string;
+  /** Deprecated leftover from the old `@electrojs/types` package layout. */
+  readonly packageJson?: string;
+}
+/** Output from the `generate()` function. */
+interface GeneratorOutput {
+  /** Generated files: preload scripts and runtime registry. */
+  readonly files: readonly GeneratedFile[];
+  /** The runtime package `electro-env.d.ts` ambient type declaration file. */
+  readonly envTypes: GeneratedFile;
+  /** Per-view renderer package `electro-env.d.ts` outputs. */
+  readonly packageTypes: readonly PackageTypeOutput[];
+}
+/** A generated file with its output path and content. */
+interface GeneratedFile {
+  readonly path: string;
+  readonly content: string;
+}
+/** A diagnostic message produced during validation. */
+interface CodegenDiagnostic {
+  readonly code: string;
+  readonly message: string;
+  readonly filePath?: string;
+}
+//#endregion
+//#region src/scanner/index.d.ts
+/**
+ * Scan a project directory for Electro decorators and return a normalized result.
+ *
+ * This is the main entry point for the codegen scanner.
+ *
+ * @param basePath - Root directory to scan for `.ts` files.
+ * @returns A {@link ScanResult} with all discovered modules, windows, and views.
+ */
+declare function scan(basePath: string): Promise<ScanResult>;
+//#endregion
+//#region src/generator/index.d.ts
+/**
+ * Generate all codegen artifacts from a scan result.
+ *
+ * 1. Validates the input (throws {@link ValidationError} on failure).
+ * 2. For each `@View()`, generates a preload script.
+ * 3. Generates the runtime registry.
+ * 4. Generates the ambient `electro-env.d.ts` type files.
+ *
+ * @param input - The generator input containing scan result, view definitions, and paths.
+ * @returns Generated files and the env types file.
+ * @throws {ValidationError} If the scan result has consistency issues.
+ */
+declare function generate(input: GeneratorInput): GeneratorOutput;
+//#endregion
+//#region src/errors.d.ts
+/** Base error class for codegen operations. */
+declare class CodegenError extends Error {
+  readonly code: string;
+  constructor(message: string, code: string);
+}
+/**
+ * Thrown when the generator detects validation issues in the scan result.
+ *
+ * Contains an array of {@link CodegenDiagnostic} entries describing each issue.
+ */
+declare class ValidationError extends CodegenError {
+  readonly diagnostics: readonly CodegenDiagnostic[];
+  constructor(diagnostics: readonly CodegenDiagnostic[]);
+}
+//#endregion
+export { type CodegenDiagnostic, CodegenError, type GeneratedFile, type GeneratorInput, type GeneratorOutput, type GeneratorViewDefinition, type PackageTypeOutput, type PackageTypeTarget, type ScanResult, type ScannedJob, type ScannedMethod, type ScannedModule, type ScannedProvider, type ScannedSignal, type ScannedView, type ScannedWindow, ValidationError, generate, scan };

package/dist/index.mjs

@@ -0,0 +1,124 @@
+import{readFileSync as e}from"node:fs";import{parseSync as t}from"oxc-parser";import{basename as n,dirname as r,isAbsolute as i,join as a,relative as o,resolve as s}from"node:path";function c(n){let r=t(n,e(n,`utf8`),{sourceType:`module`});for(let e of r.errors)console.warn(`[codegen] Parse error in ${n}: ${e.message}`);return{program:r.program,filePath:n}}function l(e){return e&&e.type===`Literal`&&typeof e.value==`string`?e.value:null}function u(e){if(!e||e.type!==`ArrayExpression`)return[];let t=[];for(let n of e.elements){let e=l(n);e!==null&&t.push(e)}return t}function d(e){if(!e||e.type!==`ArrayExpression`)return[];let t=[];for(let n of e.elements)n?.type===`Identifier`&&typeof n.name==`string`&&t.push(n.name);return t}function f(e){return e?e.type===`Identifier`&&typeof e.name==`string`?e.name:e.type===`Literal`&&typeof e.value==`string`?e.value:null:null}function p(e,t){let n=e.properties;if(!n)return null;for(let e of n)if(e.type===`Property`&&f(e.key)===t)return e.value;return null}function m(e){return e&&e.type===`Identifier`&&typeof e.name==`string`?e.name:null}function h(e){return(e.type===`ClassDeclaration`||e.type===`ClassExpression`)&&e.id?m(e.id):null}function g(e,t){let n=Array.isArray(t)?t:[t],r=e.decorators??[];for(let e of r){if(e.type!==`Decorator`)continue;let t=e.expression;if(t.type===`Identifier`&&n.includes(t.name))return t;if(t.type===`CallExpression`){let e=t.callee;if(e.type===`Identifier`&&n.includes(e.name))return t}}return null}function _(e,t){let n=g(e,t);if(!n||n.type!==`CallExpression`)return null;let r=n.arguments[0];return!r||r.type!==`ObjectExpression`?null:r}function v(e){let t=new Set,n=e.body;if(!n)return t;for(let e of n){if(e.type===`ExportNamedDeclaration`){let n=e.declaration;if(n?.type===`ClassDeclaration`||n?.type===`FunctionDeclaration`||n?.type===`TSInterfaceDeclaration`||n?.type===`TSTypeAliasDeclaration`){let e=m(n.id);e&&t.add(e);continue}if(n?.type===`VariableDeclaration`){for(let e of n.declarations){let n=m(e.id);n&&t.add(n)}continue}for(let n of e.specifiers??[]){if(n.type!==`ExportSpecifier`)continue;let e=m(n.local);e&&t.add(e)}continue}if(e.type===`ExportDefaultDeclaration`){let n=e.declaration,r=m(n)||m(n?.id??null);r&&t.add(r)}}return t}function y(e,t){let n=t?.trim();if(n&&n.length>0)return n;let r=e.endsWith(`Module`)?e.slice(0,-6):e,i=r.length>0?r:e;return i.charAt(0).toLowerCase()+i.slice(1)}function b(e,t){let n=t?.trim();return n&&n.length>0?n:e}function x(e,t){let n=e.trim();if(n.startsWith(`view:`)){let e=n.slice(5).trim();return e.length>0?e:null}let r=t?.trim();return r&&r.length>0?r:null}const S=new Set([`onInit`,`onReady`,`onShutdown`,`onDispose`]);function C(e){if(!e||e.type!==`CallExpression`)return!1;let t=e.callee;if(t?.type!==`Identifier`||t.name!==`inject`)return!1;let n=e.arguments??[];return n[0]?.type===`Identifier`&&n[0].name===`SignalBus`}function ee(e){let t=new Set,n=e.body?.body??[];for(let e of n){if(e.type!==`PropertyDefinition`||e.computed||!C(e.value))continue;let n=f(e.key);n&&t.add(n)}return t}function w(e){let t=e.value?.params??[],n=[];return t.forEach((e,t)=>{let r=m(e);r&&n.push({index:t,name:r})}),n}function T(e,t){let n=e.find(e=>e.name===t);return n?n.index:null}function te(e,t){if(!e)return{kind:`void`};if(e.type===`Identifier`){if(e.name===`undefined`)return{kind:`void`};let n=T(t,e.name);return n===null?{kind:`unknown`}:{kind:`method-parameter`,parameterIndex:n}}if(e.type!==`ObjectExpression`)return{kind:`unknown`};let n=null,r=[];for(let t of e.properties??[]){if(t.type!==`Property`||t.kind!==`init`||t.computed)return{kind:`unknown`};let e=f(t.key),i=t.value;if(!e||!i||i.type!==`MemberExpression`||i.computed)return{kind:`unknown`};let a=m(i.object),o=f(i.property);if(!a||!o||e!==o)return{kind:`unknown`};if(n===null)n=a;else if(n!==a)return{kind:`unknown`};r.push(e)}if(!n)return{kind:`unknown`};let i=T(t,n);return i===null?{kind:`unknown`}:{kind:`method-parameter-pick`,parameterIndex:i,keys:r}}function E(e,t){if(!e||e.type!==`MemberExpression`||e.computed)return!1;let n=f(e.property);return e.object?.type===`ThisExpression`&&!!n&&t.has(n)}function D(e,t){return E(e,t)||C(e)}function O(e,t){if(!(!e||typeof e!=`object`)){t(e);for(let n of Object.values(e)){if(Array.isArray(n)){for(let e of n)O(e,t);continue}O(n,t)}}}function k(e,t,n,r){let i=[],a=w(e);return O(e.value?.body,e=>{if(e.type!==`CallExpression`)return;let o=e.callee;if(!o||o.type!==`MemberExpression`||o.computed||!D(o.object,r))return;let s=f(o.property);if(s!==`publish`&&s!==`subscribe`)return;let c=e.arguments??[],u=l(c[0]);u&&i.push({id:u,methodName:n,ownerClassName:t,source:s,payload:s===`publish`?te(c[1],a):{kind:`unknown`}})}),i}function A(e,t){let n=[],r=[],i=[],a=ee(e),o=e.body?.body??[];for(let e of o){if(e.type!==`MethodDefinition`||e.kind!==`method`||e.computed||e.static||e.accessibility===`private`)continue;let o=f(e.key);if(!o||(r.push(...k(e,t,o,a)),S.has(o)))continue;let s=g(e,`command`),c=g(e,`query`),u=g(e,`signal`),d=g(e,`job`);if(s||c){let r=_(e,s?`command`:`query`),i=l(r?p(r,`id`):null);n.push({id:b(o,i),methodName:o,kind:s?`command`:`query`,ownerClassName:t})}if(u){let n=_(e,`signal`),i=l(n?p(n,`id`):null);r.push({id:b(o,i),methodName:o,ownerClassName:t,source:`decorator`,payload:{kind:`method-parameter`,parameterIndex:0}})}if(d){let n=_(e,`job`),r=l(n?p(n,`id`):null),a=l(n?p(n,`cron`):null);i.push({id:b(o,r),methodName:o,ownerClassName:t,cron:a})}}return{methods:n,signals:r,jobs:i}}function ne(e,t){let n=v(e),r=[],i=[],a=[],o=[],s=e.body;if(!s)return{modules:r,providers:i,windows:a,views:o};for(let e of s){let s=null;if(e.type===`ClassDeclaration`?s=e:(e.type===`ExportNamedDeclaration`&&e.declaration?.type===`ClassDeclaration`||e.type===`ExportDefaultDeclaration`&&e.declaration?.type===`ClassDeclaration`)&&(s=e.declaration),!s)continue;let c=h(s);if(!c)continue;let f=n.has(c);if(g(s,`Module`)){let e=_(s,`Module`),n=l(e?p(e,`id`):null),i=[...d(e?p(e,`imports`):null),...d(e?p(e,`dependsOn`):null)],a=[...d(e?p(e,`providers`):null),...d(e?p(e,`services`):null)],{methods:o,signals:u,jobs:m}=A(s,c);r.push({kind:`module`,id:y(c,n),className:c,filePath:t,exported:f,importClassNames:[...new Set(i)],providerClassNames:[...new Set(a)],methods:o,signals:u,jobs:m});continue}if(g(s,`Injectable`)){let{methods:e,signals:n,jobs:r}=A(s,c);i.push({kind:`injectable`,className:c,filePath:t,exported:f,methods:e,signals:n,jobs:r});continue}if(g(s,`Window`)){let{methods:e,signals:n,jobs:r}=A(s,c),o=_(s,`Window`),u=l(o?p(o,`id`):null);if(!u){console.warn(`[codegen] Skipping @Window() with non-literal id in ${t}`);continue}i.push({kind:`injectable`,className:c,filePath:t,exported:f,methods:e,signals:n,jobs:r}),a.push({id:u,className:c,filePath:t,exported:f});continue}if(g(s,`View`)){let{methods:e,signals:n,jobs:r}=A(s,c),a=_(s,`View`),d=l(a?p(a,`source`):null);if(!d){console.warn(`[codegen] Skipping @View() with non-literal source in ${t}`);continue}let m=x(d,l(a?p(a,`id`):null));if(!m){console.warn(`[codegen] Skipping @View() with non-literal id in ${t}`);continue}i.push({kind:`injectable`,className:c,filePath:t,exported:f,methods:e,signals:n,jobs:r}),o.push({id:m,className:c,filePath:t,exported:f,source:d,access:u(a?p(a,`access`):null),signals:u(a?p(a,`signals`):null)})}}return{modules:r,providers:i,windows:a,views:o}}const re=[/\.d\.ts$/,/\.test\.ts$/,/\.spec\.ts$/,/\.gen\.ts$/];function ie(e){return n(e).startsWith(`._`)||e.includes(`/__MACOSX/`)?!1:e.endsWith(`.ts`)&&!re.some(t=>t.test(e))}async function ae(e){let{glob:t}=await import(`tinyglobby`);return(await t([`**/*.ts`],{cwd:e,absolute:!0,ignore:[`node_modules/**`,`**/__MACOSX/**`,`**/.DS_Store`,`**/._*`]})).filter(ie).sort()}async function oe(e){let t=await ae(e),n=[],r=[],i=[],a=[];for(let e of t){let{program:t}=c(e),o=ne(t,e);n.push(...o.modules),r.push(...o.providers),i.push(...o.windows),a.push(...o.views)}let o=new Map(r.map(e=>[e.className,e])),s=new Map(n.map(e=>[e.className,e]));return{modules:n.map(e=>{let t=[];for(let n of e.providerClassNames){let r=o.get(n);if(!r){console.warn(`[codegen] Module "${e.id}" references unknown provider class "${n}" in ${e.filePath}`);continue}t.push({className:r.className,filePath:r.filePath,exported:r.exported,methods:[...r.methods],signals:[...r.signals],jobs:[...r.jobs]})}let n=[];for(let t of e.importClassNames){let r=s.get(t);if(!r){console.warn(`[codegen] Module "${e.id}" references unknown module class "${t}" in ${e.filePath}`);continue}n.push(r.id)}return{id:e.id,className:e.className,filePath:e.filePath,exported:e.exported,imports:[...new Set(n)],providers:t,methods:[...e.methods],signals:[...e.signals],jobs:[...e.jobs]}}),windows:i,views:a}}function j(e,t){let n=o(r(e),t).replaceAll(`\\`,`/`).replace(/\.(?:[cm]?tsx?|[cm]?jsx?)$/,``);return n.startsWith(`.`)?n:`./${n}`}function M(e,t){let n=o(r(e),t).replaceAll(`\\`,`/`);return n.startsWith(`.`)?n:`./${n}`}function N(e){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e)?e:JSON.stringify(e)}const P=`// Auto-generated by Electro codegen. Do not edit.
+`;function F(e){switch(e.source){case`decorator`:return 400;case`publish`:switch(e.payload.kind){case`method-parameter-pick`:return 350;case`method-parameter`:return 340;case`void`:return 330;case`unknown`:return 320}case`subscribe`:return 100}}function I(e,t){return F(t)>F(e)}function L(e){let t=new Map,n=(e,n)=>{let r=t.get(e.id);(!r||I(r.signal,e))&&t.set(e.id,{signal:e,filePath:n})};for(let t of e){for(let e of t.signals)n(e,t.filePath);for(let e of t.providers)for(let t of e.signals)n(t,e.filePath)}return t}const R=`${P}// @ts-nocheck
+// Electro runtime authoring contract types — provides IDE completions for modules, signals, jobs, windows, and runtime-declared views.
+
+export {};
+
+type _Instance<T> = T extends abstract new (...args: never[]) => infer R ? R : never;
+type _ModuleAuthoringApi<TModuleId extends import("@electrojs/runtime").ModuleRegistryId> =
+    import("@electrojs/runtime").ModuleAuthoringApi<TModuleId>;
+type _WindowAuthoringApi = import("@electrojs/runtime").WindowAuthoringApi;
+type _ViewAuthoringApi = import("@electrojs/runtime").ViewAuthoringApi;
+type _InvokeMethod<T, K extends PropertyKey> =
+    K extends keyof _Instance<T>
+        ? _Instance<T>[K] extends (...args: infer A) => infer V
+            ? (...args: A) => Promise<Awaited<V>>
+            : never
+        : never;
+type _SignalPayloadFromMethodParam<T, K extends PropertyKey, I extends number> =
+    K extends keyof _Instance<T>
+        ? _Instance<T>[K] extends (...args: infer A) => infer _Ignored
+            ? I extends keyof A
+                ? A[I]
+                : void
+            : never
+        : never;
+type _SignalPayloadFromMethod<T, K extends PropertyKey> =
+    _SignalPayloadFromMethodParam<T, K, 0>;
+`;function z(e,t,n){return`_InvokeMethod<typeof import("${j(e,n)}").${t.ownerClassName}, ${JSON.stringify(t.methodName)}>`}function B(e,t,n){let r=`typeof import("${j(e,n)}").${t.ownerClassName}`;switch(t.payload.kind){case`method-parameter`:return t.source===`decorator`&&t.payload.parameterIndex===0?`_SignalPayloadFromMethod<${r}, ${JSON.stringify(t.methodName)}>`:`_SignalPayloadFromMethodParam<${r}, ${JSON.stringify(t.methodName)}, ${t.payload.parameterIndex}>`;case`method-parameter-pick`:{let e=t.payload.keys.map(e=>JSON.stringify(e)).join(` | `)||`never`;return`Pick<_SignalPayloadFromMethodParam<${r}, ${JSON.stringify(t.methodName)}, ${t.payload.parameterIndex}>, ${e}>`}case`void`:return`void`;case`unknown`:return`unknown`}}function V(e,t){let n=[];for(let r of e){for(let e of r.methods){let i=`${r.id}:${e.id}`;n.push(`        ${JSON.stringify(i)}: ${z(t,e,r.filePath)};`)}for(let e of r.providers)for(let i of e.methods){let a=`${r.id}:${i.id}`;n.push(`        ${JSON.stringify(a)}: ${z(t,i,e.filePath)};`)}}return`\n    interface ModuleMethodMap {\n${n.join(`
+`)}\n    }\n`}function H(e,t){return`\n    interface ModuleApiRegistry {\n${e.filter(e=>e.exported).map(e=>{let n=[...e.methods.map(t=>({method:t,filePath:e.filePath})),...e.providers.flatMap(e=>e.methods.map(t=>({method:t,filePath:e.filePath})))].map(({method:e,filePath:n})=>`            ${N(e.id)}: ${z(t,e,n)};`),r=n.length>0?`{\n${n.join(`
+`)}\n        }`:`{}`;return`        ${JSON.stringify(e.id)}: ${r};`}).join(`
+`)}\n    }\n`}function U(e,t){let n=new Map;for(let r of L(e).values())n.set(r.signal.id,`        ${JSON.stringify(r.signal.id)}: ${B(t,r.signal,r.filePath)};`);return`\n    interface ModuleSignalPayloadMap {\n${[...n.values()].join(`
+`)}\n    }\n`}function W(e){return`\n    interface ModuleJobRegistry {\n${e.map(e=>{let t=[...new Set([...e.jobs.map(e=>e.id),...e.providers.flatMap(e=>e.jobs.map(e=>e.id))])],n=t.length>0?t.map(e=>JSON.stringify(e)).join(` | `):`never`;return`        ${JSON.stringify(e.id)}: ${n};`}).join(`
+`)}\n    }\n`}function G(e,t){let n=new Map;for(let r of e)for(let e of r.providers)if(e.exported&&!n.has(e.className)){let r=j(t,e.filePath);n.set(e.className,`        ${JSON.stringify(e.className)}: typeof import("${r}").${e.className};`)}return`\n    interface InjectableClassRegistry {\n${[...n.values()].join(`
+`)}\n    }\n`}function K(e,t){return`\n    interface WindowClassRegistry {\n${e.filter(e=>e.exported).map(e=>{let n=j(t,e.filePath);return`        ${JSON.stringify(e.id)}: typeof import("${n}").${e.className};`}).join(`
+`)}\n    }\n`}function q(e,t){return`\n    interface ViewClassRegistry {\n${e.filter(e=>e.exported).map(e=>{let n=j(t,e.filePath);return`        ${JSON.stringify(e.id)}: typeof import("${n}").${e.className};`}).join(`
+`)}\n    }\n`}function se(e){return`\n    interface ViewAccessRegistry {\n${[...new Set([...e.flatMap(e=>e.methods.map(t=>`${e.id}:${t.id}`)),...e.flatMap(e=>e.providers.flatMap(t=>t.methods.map(t=>`${e.id}:${t.id}`)))])].map(e=>`        ${JSON.stringify(e)}: true;`).join(`
+`)}\n    }\n`}function ce(e){return`\n    interface ViewSignalRegistry {\n${[...L(e).keys()].map(e=>`        ${JSON.stringify(e)}: true;`).join(`
+`)}\n    }\n`}function le(e){return`\n    interface BundledViewIdRegistry {\n${e.filter(e=>e.source.startsWith(`view:`)).map(e=>e.id).map(e=>`        ${JSON.stringify(e)}: true;`).join(`
+`)}\n    }\n`}function ue(e,t){let n=new Set,r=new Set(e.views.map(e=>e.className)),i=new Set(e.windows.map(e=>e.className)),a=(e,r,i,a,o)=>{if(!a)return;let s=j(t,e),c;switch(i){case`module`:c=`_ModuleAuthoringApi<${JSON.stringify(o)}>`;break;case`window`:c=`_WindowAuthoringApi`;break;case`view`:c=`_ViewAuthoringApi`;break}n.add(`import "${s}";\ndeclare module "${s}" {\n    interface ${r} extends ${c} {}\n}`)};for(let t of e.modules){a(t.filePath,t.className,`module`,t.exported,t.id);for(let e of t.providers)r.has(e.className)||i.has(e.className)||a(e.filePath,e.className,`module`,e.exported,t.id)}for(let t of e.windows)a(t.filePath,t.className,`window`,t.exported);for(let t of e.views)a(t.filePath,t.className,`view`,t.exported);return n.size>0?`\n${[...n].join(`
+
+`)}\n`:`
+`}function de(e,t){let n=a(t,`electro-env.d.ts`);return{path:`electro-env.d.ts`,content:`${R}
+declare module "@electrojs/runtime" {
+${V(e.modules,n)}${H(e.modules,n)}${U(e.modules,n)}${W(e.modules)}${G(e.modules,n)}${K(e.windows,n)}${q(e.views,n)}
+}
+
+declare module "@electrojs/common" {
+${se(e.modules)}${ce(e.modules)}${le(e.views)}
+}${ue(e,n)}`}}const fe=`${P}// @ts-nocheck
+// Electro renderer bridge contract types — provides IDE completions for bridge access and forwarded signals.
+
+export {};
+
+type _Instance<T> = T extends abstract new (...args: never[]) => infer R ? R : never;
+type _SignalPayloadFromMethodParam<T, K extends PropertyKey, I extends number> =
+    K extends keyof _Instance<T>
+        ? _Instance<T>[K] extends (...args: infer A) => infer _Ignored
+            ? I extends keyof A
+                ? A[I]
+                : void
+            : never
+        : never;
+type _SignalPayloadFromMethod<T, K extends PropertyKey> =
+    _SignalPayloadFromMethodParam<T, K, 0>;
+type _BridgeInputFromMethod<T, K extends PropertyKey> =
+    K extends keyof _Instance<T>
+        ? _Instance<T>[K] extends (...args: infer A) => infer _Ignored
+            ? A extends []
+                ? undefined
+                : A extends [infer TOnly]
+                    ? TOnly
+                    : A
+            : never
+        : never;
+type _BridgeOutputFromMethod<T, K extends PropertyKey> =
+    K extends keyof _Instance<T>
+        ? _Instance<T>[K] extends (...args: infer _Args) => infer V
+            ? Awaited<V>
+            : never
+        : never;
+`;function pe(e,t){let n=new Set(e.access),r=[];for(let e of t){for(let t of e.methods)n.has(`${e.id}:${t.id}`)&&r.push({moduleId:e.id,method:t,filePath:e.filePath});for(let t of e.providers)for(let i of t.methods)n.has(`${e.id}:${i.id}`)&&r.push({moduleId:e.id,method:i,filePath:t.filePath})}return r}function me(e,t){let n=new Set(e.signals),r=[];for(let e of L(t).values())n.has(e.signal.id)&&r.push({signal:e.signal,filePath:e.filePath});return r}function he(e,t){return`_BridgeInputFromMethod<typeof import("${j(e,t.filePath)}").${t.method.ownerClassName}, ${JSON.stringify(t.method.methodName)}>`}function ge(e,t){return`_BridgeOutputFromMethod<typeof import("${j(e,t.filePath)}").${t.method.ownerClassName}, ${JSON.stringify(t.method.methodName)}>`}function _e(e,t){return`import("@electrojs/renderer").BridgeContractEntry<${he(e,t)}, ${ge(e,t)}>`}function ve(e,t){let n=`typeof import("${j(e,t.filePath)}").${t.signal.ownerClassName}`;switch(t.signal.payload.kind){case`method-parameter`:return t.signal.source===`decorator`&&t.signal.payload.parameterIndex===0?`_SignalPayloadFromMethod<${n}, ${JSON.stringify(t.signal.methodName)}>`:`_SignalPayloadFromMethodParam<${n}, ${JSON.stringify(t.signal.methodName)}, ${t.signal.payload.parameterIndex}>`;case`method-parameter-pick`:{let e=t.signal.payload.keys.map(e=>JSON.stringify(e)).join(` | `)||`never`;return`Pick<_SignalPayloadFromMethodParam<${n}, ${JSON.stringify(t.signal.methodName)}, ${t.signal.payload.parameterIndex}>, ${e}>`}case`void`:return`void`;case`unknown`:return`unknown`}}function ye(e,t,n){let r=pe(e,t),i=me(e,t),a=e=>r.filter(t=>t.method.kind===e).map(e=>`        ${JSON.stringify(`${e.moduleId}:${e.method.id}`)}: ${_e(n,e)};`).join(`
+`);return`declare module "@electrojs/renderer" {
+    interface BridgeQueries {
+${[a(`query`),a(`command`)].filter(Boolean).join(`
+`)}
+    }
+
+    interface BridgeCommands {
+${a(`command`)}
+    }
+
+    interface BridgeSignals {
+${i.map(e=>`        ${JSON.stringify(e.signal.id)}: ${ve(n,e)};`).join(`
+`)}
+    }
+}`}function be(e,t,n){return`${fe}
+${t?ye(t,e.modules,n):``}
+`}function xe(e,t){return t.map(t=>{let n=a(t.packageRoot,`electro-env.d.ts`),r=be(e,e.views.find(e=>e.id===t.viewId),n);return{packageRoot:t.packageRoot,path:`electro-env.d.ts`,content:r,indexDts:r}})}function Se(e,t,n){let a=n.trim();return a.length===0||!(a.startsWith(`.`)||i(a))?a:M(t,i(a)?a:s(r(e.__source),a))}function Ce(e,t,n){let r=`generated/preload/${e.id}.gen.ts`,i=`${n}/${r}`,a=`${P}
+import { contextBridge, ipcRenderer } from "electron";
+import { createBridgeClient } from "@electrojs/runtime/client";
+
+contextBridge.exposeInMainWorld("__ELECTRO_RENDERER__", createBridgeClient({
+    viewId: ${JSON.stringify(e.id)},
+    ipcRenderer,
+}));
+`;if(t?.preload&&t.preload.length>0){let e=Se(t,i,t.preload);e.length>0&&(a+=`\n// User preload extension\nimport ${JSON.stringify(e)};\n`)}return{path:r,content:a}}function J(e,t){return e.id.localeCompare(t.id)||e.filePath.localeCompare(t.filePath)}function Y(e){return e.length===0?`[]`:`[\n${e.map(e=>`    ${e},`).join(`
+`)}\n]`}function X(e,t){let{modules:n,windows:r,views:i}=e;if(n.length===0&&r.length===0&&i.length===0)return null;let o=`generated/runtime/registry.gen.ts`,s=a(t,o),c=[],l=[...n].sort(J).flatMap((e,t)=>{if(!e.exported)return console.warn(`[codegen] Skipping non-exported module "${e.className}" from runtime registry`),[];let n=`__electro_module_${t}`,r=j(s,e.filePath);return c.push(`import { ${e.className} as ${n} } from "${r}";`),[{...e,localName:n}]}),u=[...r].sort(J).flatMap((e,t)=>{if(!e.exported)return console.warn(`[codegen] Skipping non-exported window "${e.className}" from runtime registry`),[];let n=`__electro_window_${t}`,r=j(s,e.filePath);return c.push(`import { ${e.className} as ${n} } from "${r}";`),[{...e,localName:n}]}),d=[...i].sort(J).flatMap((e,t)=>{if(!e.exported)return console.warn(`[codegen] Skipping non-exported view "${e.className}" from runtime registry`),[];let n=`__electro_view_${t}`,r=j(s,e.filePath);return c.push(`import { ${e.className} as ${n} } from "${r}";`),[{...e,localName:n}]}),f=new Set(l.flatMap(e=>e.imports)),p=l.filter(e=>!f.has(e.id)),m=new Set(l.map(e=>e.id));for(let e of l)for(let t of e.imports)m.has(t)||console.warn(`[codegen] Module "${e.id}" depends on non-exported module "${t}" in runtime registry`);l.length>0&&p.length===0?console.warn(`[codegen] Runtime registry found no root module candidate; skipping electroAppDefinition`):p.length>1&&console.warn(`[codegen] Runtime registry found multiple root module candidates (${p.map(e=>e.id).join(`, `)}); skipping electroAppDefinition`);let h=p.length===1,g=h?[`AppKernelDefinition`,`ModuleClass`,`ViewClass`,`WindowClass`]:[`ModuleClass`,`ViewClass`,`WindowClass`],_=Y(l.map(e=>e.localName)),v=Y(u.map(e=>e.localName)),y=Y(d.map(e=>e.localName)),b=Y(p.map(e=>e.localName)),x=p[0],S=h&&x?`\nexport const electroAppDefinition = {\n    root: ${x.localName},\n    modules: electroModules,\n    windows: electroWindows,\n    views: electroViews,\n} satisfies AppKernelDefinition;\n`:``;return{path:o,content:`${P}
+import type { ${g.join(`, `)} } from "@electrojs/runtime";
+${c.length>0?`${c.join(`
+`)}\n`:``}
+export const electroModules = ${_} as const satisfies readonly ModuleClass[];
+export const electroWindows = ${v} as const satisfies readonly WindowClass[];
+export const electroViews = ${y} as const satisfies readonly ViewClass[];
+export const electroRootModules = ${b} as const satisfies readonly ModuleClass[];
+
+export const electroRuntimeRegistry = {
+    modules: electroModules,
+    windows: electroWindows,
+    views: electroViews,
+    rootModules: electroRootModules,
+} as const;${S}
+export default electroRuntimeRegistry;
+`}}var Z=class extends Error{constructor(e,t){super(e),this.name=`CodegenError`,this.code=t}},Q=class extends Z{constructor(e){super(e.map(e=>e.message).join(`
+`),`VALIDATION_ERROR`),this.name=`ValidationError`,this.diagnostics=e}};function we(e){let t=De(e);if(t.length>0)throw new Q(t)}function $(e){let t=new Set,n=new Set;for(let r of e)t.has(r)?n.add(r):t.add(r);return[...n]}function Te(e){let t=new Set;for(let n of e.modules){for(let e of n.methods)t.add(`${n.id}:${e.id}`);for(let e of n.providers)for(let r of e.methods)t.add(`${n.id}:${r.id}`)}return t}function Ee(e){return new Set(L(e.modules).keys())}function De(e){let{scanResult:t}=e,n=[];for(let e of $(t.modules.map(e=>e.id)))n.push({code:`duplicate-module-id`,message:`Duplicate module id "${e}" detected in scan result`});for(let e of t.modules){let t=[...e.methods.map(e=>e.id),...e.providers.flatMap(e=>e.methods.map(e=>e.id))];for(let r of $(t))n.push({code:`duplicate-module-method`,message:`Module "${e.id}" exposes duplicate method id "${r}"`})}for(let e of $(t.windows.map(e=>e.id)))n.push({code:`duplicate-window-id`,message:`Duplicate window id "${e}" detected in scan result`});for(let e of $(t.views.map(e=>e.id)))n.push({code:`duplicate-view-id`,message:`Duplicate view id "${e}" detected in scan result`});let r=Te(t);for(let e of t.views)for(let t of e.access)r.has(t)||n.push({code:`unknown-access-key`,message:`View "${e.id}" references unknown access key "${t}"`,filePath:e.filePath});let i=Ee(t);for(let e of t.views)for(let t of e.signals)i.has(t)||n.push({code:`unknown-signal-key`,message:`View "${e.id}" references unknown signal key "${t}"`,filePath:e.filePath});if(e.views&&e.views.length>0){let r=new Set(t.views.map(e=>e.id));for(let t of e.views)r.has(t.id)||n.push({code:`missing-runtime-view`,message:`Generator view definition "${t.id}" has no matching @View() class`})}return n}function Oe(e){we(e);let{scanResult:t,outputDir:n,srcDir:r}=e,i=[],a=new Map;if(e.views)for(let t of e.views)a.set(t.id,t);for(let e of t.views){let t=a.get(e.id);i.push(Ce(e,t,n))}let o=X(t,n);return o&&i.push(o),{files:i,envTypes:de(t,r),packageTypes:e.packageTargets?xe(t,e.packageTargets):[]}}export{Z as CodegenError,Q as ValidationError,Oe as generate,oe as scan};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@electrojs/codegen",
+  "version": "1.0.0",
+  "description": "Code generator for electro module runtime — scans modules/views and emits bridge and registry artifacts",
+  "homepage": "https://github.com/MyraxByte/electrojs#readme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MyraxByte/electrojs.git",
+    "directory": "packages/codegen"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "oxc-parser": "^0.121.0",
+    "tinyglobby": "^0.2.15"
+  },
+  "devDependencies": {
+    "tsdown": "^0.21.4",
+    "vitest": "^4.1.1",
+    "@electrojs/config": "1.0.0",
+    "@electrojs/runtime": "1.0.0",
+    "@electrojs/common": "1.0.0"
+  },
+  "peerDependencies": {
+    "@electrojs/common": ">=1",
+    "@electrojs/config": ">=1",
+    "@electrojs/runtime": ">=1",
+    "@types/node": "^25.5.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest"
+  }
+}