@publish.os/nextjs 0.0.1-alpha.8 → 0.0.1-alpha.90

package/dist/compiler.d.ts

@@ -6,11 +6,13 @@ type LocalOperationContext = {
     outputDir: string;
     signal: AbortSignal;
     replaceOutput: (run: (stagingDir: string) => Promise<void>) => Promise<void>;
-    onShutdown: (stop: () => Promise<void>) => void;
+    onShutdown: (stop: () => Promise<void>) => () => void;
 };
 type LocalOperationOptions<T> = {
     sourceRoot: string;
     operation: "build" | "dev";
+    /** Private stable identity for one checkout preview; never an output path. */
+    scope?: string;
     outputDir?: string;
     signal?: AbortSignal;
     run: (context: LocalOperationContext) => Promise<T>;
@@ -24,6 +26,17 @@ type FrameworkRequest = {
         originalSource?: string;
     };
     context?: {
+        /** Explicit maintainer input. Omitted when execution follows the authored pin. */
+        framework?: {
+            packageName: "@publish.os/nextjs";
+            version: string;
+        } & ({
+            kind: "checkout";
+            packageRoot: string;
+        } | {
+            kind: "candidate";
+            integrity: string;
+        });
         archive?: {
             path: string;
             integrity: string;
@@ -37,18 +50,16 @@ type FrameworkRequest = {
         sourceRevision?: string;
         /** Exact caller-owned pnpm executable. Local commands never search PATH. */
         pnpmExecutable?: string;
-        /** Request local IDE preparation; omitted for hosted validation and composition. */
+        /** IDE selection is separate from runtime; preserve retains valid external Dev setup. */
         ide?: {
             finalSourceRoot?: string;
+            policy?: "preserve";
         };
         /** Local development origin, supplied after selecting an available port. */
         previewUrl?: string;
     };
-    consent?: {
-        installation?: boolean;
-        composition?: boolean;
-    };
     port?: number;
+    portExplicit?: boolean;
 };
 type FrameworkDiagnostic = {
     code: string;
@@ -58,6 +69,9 @@ type FrameworkDiagnostic = {
     line?: number;
     column?: number;
     correction?: string;
+    sourceLine?: string;
+    length?: number;
+    propertyPath?: string;
 };
 type FrameworkGate = {
     id: string;
@@ -67,11 +81,23 @@ type FrameworkGate = {
 type FrameworkEvent = {
     type: "progress";
     message: string;
+} | {
+    type: "restart";
+    target: "compiler" | "next";
+    reason: string;
 } | {
     type: "diagnostics";
     diagnostics: {
         diagnostics: FrameworkDiagnostic[];
     };
+} | {
+    type: "changes";
+    changes: {
+        action: "added" | "edited" | "deleted";
+        path: string;
+    }[];
+} | {
+    type: "updated";
 } | {
     type: "ready";
     url: string;
@@ -92,9 +118,17 @@ type RunFrameworkOptions = {
     onGate?: (gate: FrameworkGate) => boolean | Promise<boolean>;
 };
 
+/** Serialize checkout dependency mutations, not the lifetime of a preview. */
+declare function withCheckoutPreparation<T>({ packageRoot, workspaceRoot, signal, prepare, }: {
+    packageRoot: string;
+    workspaceRoot?: string;
+    signal?: AbortSignal;
+    prepare: (confirmStopped: () => void) => Promise<T>;
+}): Promise<T>;
+
 /** Own one local writer for its complete build or development lifetime. */
 declare function withLocalOperation<T>(options: LocalOperationOptions<T>): Promise<T>;
 
 declare function runFramework(options: RunFrameworkOptions): Promise<FrameworkResult>;
 
-export { type FrameworkDiagnostic, type FrameworkEvent, type FrameworkGate, type FrameworkOperation, type FrameworkRequest, type FrameworkResult, type LocalOperationContext, type LocalOperationOptions, type RunFrameworkOptions, runFramework, withLocalOperation };
+export { type FrameworkDiagnostic, type FrameworkEvent, type FrameworkGate, type FrameworkOperation, type FrameworkRequest, type FrameworkResult, type LocalOperationContext, type LocalOperationOptions, type RunFrameworkOptions, runFramework, withCheckoutPreparation, withLocalOperation };