@pyreon/compiler 0.15.0 → 0.16.0

package/lib/types/index.d.ts

@@ -206,6 +206,14 @@ declare function diagnoseError(error: string): ErrorDiagnosis | null;
  *  - `as-unknown-as-vnodechild` — defensive `as unknown as VNodeChild`
  *                       cast on JSX returns is unnecessary (`JSX.Element`
  *                       is already assignable to `VNodeChild`).
+ *  - `island-never-with-registry-entry` — an `island()` declared with
+ *                       `hydrate: 'never'` is also registered in the same
+ *                       file's `hydrateIslands({ ... })` call. The whole
+ *                       point of `'never'` is shipping zero client JS;
+ *                       registering pulls the component module into the
+ *                       client bundle graph (the runtime short-circuits
+ *                       and never calls the loader, but the bundler still
+ *                       includes the import). Drop the registry entry.
  *
  * Two-mode surface mirrors `react-intercept.ts`:
  *  - `detectPyreonPatterns(code)` — diagnostics only
@@ -226,7 +234,7 @@ declare function diagnoseError(error: string): ErrorDiagnosis | null;
  *  2. CLI `pyreon doctor`
  *  3. MCP server `validate` tool
  */
-type PyreonDiagnosticCode = 'for-missing-by' | 'for-with-key' | 'props-destructured' | 'process-dev-gate' | 'empty-theme' | 'raw-add-event-listener' | 'raw-remove-event-listener' | 'date-math-random-id' | 'on-click-undefined' | 'signal-write-as-call' | 'static-return-null-conditional' | 'as-unknown-as-vnodechild';
+type PyreonDiagnosticCode = 'for-missing-by' | 'for-with-key' | 'props-destructured' | 'process-dev-gate' | 'empty-theme' | 'raw-add-event-listener' | 'raw-remove-event-listener' | 'date-math-random-id' | 'on-click-undefined' | 'signal-write-as-call' | 'static-return-null-conditional' | 'as-unknown-as-vnodechild' | 'island-never-with-registry-entry';
 interface PyreonDiagnostic {
   /** Machine-readable code for filtering + programmatic handling */
   code: PyreonDiagnosticCode;
@@ -292,5 +300,92 @@ declare function formatTestAudit(result: TestAuditResult, {
   limit
 }?: AuditFormatOptions): string;
 //#endregion
-export { type AuditFormatOptions, type AuditRisk, type CompilerWarning, type ComponentInfo, type ErrorDiagnosis, type IslandInfo, type MigrationChange, type MigrationResult, type ProjectContext, type PyreonDiagnostic, type PyreonDiagnosticCode, type ReactDiagnostic, type ReactDiagnosticCode, type RouteInfo, type TestAuditEntry, type TestAuditResult, type TransformResult, auditTestEnvironment, detectPyreonPatterns, detectReactPatterns, diagnoseError, formatTestAudit, generateContext, hasPyreonPatterns, hasReactPatterns, migrateReactCode, transformJSX, transformJSX_JS };
+//#region src/island-audit.d.ts
+type IslandFindingCode = 'never-with-registry-entry' | 'duplicate-name' | 'registry-mismatch' | 'nested-island' | 'dead-island';
+interface IslandLocation {
+  /** Absolute path */
+  path: string;
+  /** Path relative to the repo root for readable reporting */
+  relPath: string;
+  /** 1-based line number */
+  line: number;
+  /** 1-based column number */
+  column: number;
+}
+interface IslandFinding {
+  code: IslandFindingCode;
+  /** One-paragraph human-readable explanation, including the fix path. */
+  message: string;
+  /** Where the finding surfaces. */
+  location: IslandLocation;
+  /**
+   * Companion locations for cross-file findings (`duplicate-name` lists
+   * the OTHER occurrence; `nested-island` lists the inner island's
+   * declaration; `never-with-registry-entry` lists the matching island
+   * declaration).
+   */
+  related?: IslandLocation[] | undefined;
+}
+interface IslandAuditResult {
+  root: string | null;
+  findings: IslandFinding[];
+  summary: {
+    filesScanned: number;
+    islandsDeclared: number;
+    registryEntries: number;
+    findingsByCode: Record<IslandFindingCode, number>;
+  };
+}
+declare function auditIslands(rootDir: string): IslandAuditResult;
+interface IslandAuditFormatOptions {
+  /** When true, emit JSON instead of markdown-ish text. */
+  json?: boolean | undefined;
+}
+declare function formatIslandAudit(result: IslandAuditResult, options?: IslandAuditFormatOptions): string;
+//#endregion
+//#region src/ssg-audit.d.ts
+type SsgFindingCode = '404-outside-layout-dir' | 'dynamic-route-missing-get-static-paths' | 'non-literal-revalidate-export';
+interface SsgLocation {
+  /** Absolute path */
+  path: string;
+  /** Path relative to the repo root for readable reporting */
+  relPath: string;
+  /** 1-based line number */
+  line: number;
+  /** 1-based column number */
+  column: number;
+}
+interface SsgFinding {
+  code: SsgFindingCode;
+  /** One-paragraph human-readable explanation, including the fix path. */
+  message: string;
+  /** Where the finding surfaces. */
+  location: SsgLocation;
+  /**
+   * Companion locations for cross-file findings. Not currently emitted
+   * by any detector but kept in the contract so future codes have the
+   * shape available without an API change.
+   */
+  related?: SsgLocation[] | undefined;
+}
+interface SsgAuditResult {
+  root: string | null;
+  findings: SsgFinding[];
+  summary: {
+    filesScanned: number;
+    routesScanned: number;
+    dynamicRoutes: number;
+    revalidateExports: number;
+    findingsByCode: Record<SsgFindingCode, number>;
+  };
+}
+declare function auditSsg(rootDir: string): SsgAuditResult;
+interface SsgAuditFormatOptions {
+  /** Filter findings to a minimum severity. Currently all SSG findings
+   *  are 'warning'-level; reserved for future severity tiers. */
+  minSeverity?: 'warning' | 'error' | undefined;
+}
+declare function formatSsgAudit(result: SsgAuditResult, _options?: SsgAuditFormatOptions): string;
+//#endregion
+export { type AuditFormatOptions, type AuditRisk, type CompilerWarning, type ComponentInfo, type ErrorDiagnosis, type IslandAuditFormatOptions, type IslandAuditResult, type IslandFinding, type IslandFindingCode, type IslandInfo, type IslandLocation, type MigrationChange, type MigrationResult, type ProjectContext, type PyreonDiagnostic, type PyreonDiagnosticCode, type ReactDiagnostic, type ReactDiagnosticCode, type RouteInfo, type SsgAuditFormatOptions, type SsgAuditResult, type SsgFinding, type SsgFindingCode, type SsgLocation, type TestAuditEntry, type TestAuditResult, type TransformResult, auditIslands, auditSsg, auditTestEnvironment, detectPyreonPatterns, detectReactPatterns, diagnoseError, formatIslandAudit, formatSsgAudit, formatTestAudit, generateContext, hasPyreonPatterns, hasReactPatterns, migrateReactCode, transformJSX, transformJSX_JS };
 //# sourceMappingURL=index2.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/compiler",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Template and JSX compiler for Pyreon",
   "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/compiler#readme",
   "bugs": {
@@ -36,6 +36,7 @@
   },
   "scripts": {
     "build": "vl_rolldown_build",
+    "build:native": "bun scripts/build-native.ts",
     "dev": "vl_rolldown_build-watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
@@ -45,11 +46,20 @@
   "dependencies": {
     "oxc-parser": "^0.129.0"
   },
+  "optionalDependencies": {
+    "@pyreon/compiler-darwin-arm64": "workspace:^",
+    "@pyreon/compiler-darwin-x64": "workspace:^",
+    "@pyreon/compiler-linux-arm64-gnu": "workspace:^",
+    "@pyreon/compiler-linux-arm64-musl": "workspace:^",
+    "@pyreon/compiler-linux-x64-gnu": "workspace:^",
+    "@pyreon/compiler-linux-x64-musl": "workspace:^",
+    "@pyreon/compiler-win32-x64-msvc": "workspace:^"
+  },
   "devDependencies": {
-    "@pyreon/core": "^0.15.0",
-    "@pyreon/reactivity": "^0.15.0",
-    "@pyreon/runtime-dom": "^0.15.0",
-    "@pyreon/test-utils": "^0.13.2",
+    "@pyreon/core": "^0.16.0",
+    "@pyreon/reactivity": "^0.16.0",
+    "@pyreon/runtime-dom": "^0.16.0",
+    "@pyreon/test-utils": "^0.13.3",
     "happy-dom": "^20.8.3"
   },
   "peerDependencies": {

package/src/index.ts

@@ -26,3 +26,20 @@ export type {
   TestAuditResult,
 } from './test-audit'
 export { auditTestEnvironment, formatTestAudit } from './test-audit'
+export type {
+  IslandAuditFormatOptions,
+  IslandAuditResult,
+  IslandFinding,
+  IslandFindingCode,
+  IslandLocation,
+} from './island-audit'
+export { auditIslands, formatIslandAudit } from './island-audit'
+// M3.4 — `pyreon doctor --check-ssg` audit.
+export type {
+  SsgAuditFormatOptions,
+  SsgAuditResult,
+  SsgFinding,
+  SsgFindingCode,
+  SsgLocation,
+} from './ssg-audit'
+export { auditSsg, formatSsgAudit } from './ssg-audit'