@publish.os/nextjs 0.0.1-alpha.81 → 0.0.1-alpha.91

package/dist/chunk-WL75GQ5M.js

@@ -0,0 +1,80 @@
+// src/lib/compiler/internal/path-containment.ts
+import * as systemPath from "path";
+function relativePath(parent, child, pathImplementation) {
+  return pathImplementation.relative(
+    pathImplementation.resolve(parent),
+    pathImplementation.resolve(child)
+  );
+}
+function isContainedRelativePath(path, pathImplementation) {
+  return !pathImplementation.isAbsolute(path) && path !== ".." && !path.startsWith(`..${pathImplementation.sep}`);
+}
+function isSameOrDescendant(parent, child, pathImplementation = systemPath) {
+  let path = relativePath(parent, child, pathImplementation);
+  return path === "" || isContainedRelativePath(path, pathImplementation);
+}
+function isDescendant(parent, child, pathImplementation = systemPath) {
+  let path = relativePath(parent, child, pathImplementation);
+  return path !== "" && isContainedRelativePath(path, pathImplementation);
+}
+
+// src/lib/compiler/source/source-paths.ts
+function isOsMetadataPath(relativePath2) {
+  return relativePath2.split(/[\\/]/).includes(".DS_Store");
+}
+function isExcludedSourcePath(relativePath2) {
+  let segments = relativePath2.split(/[\\/]/);
+  return isOsMetadataPath(relativePath2) || relativePath2 === "tsconfig.json" || segments[0] === ".publish.os" || segments.includes("publish.os");
+}
+var ROOT_FILES = /* @__PURE__ */ new Set(["publish.os.config.json", "tsconfig.json"]), RENDERER_FILES = /* @__PURE__ */ new Set([
+  "layout.tsx",
+  "index.tsx",
+  "page.tsx",
+  "(index)/layout.tsx",
+  "(index)/index.tsx",
+  "(page)/layout.tsx",
+  "(page)/page.tsx"
+]), ROOT_DIRECTORIES = ["assets/", "components/", "content/"], RESERVED_DIRECTORIES = /* @__PURE__ */ new Set([
+  "app",
+  "pages",
+  "node_modules",
+  ".publish.os",
+  "[...slug]"
+]), RESERVED_FILES = /* @__PURE__ */ new Set([
+  "postcss.config.js",
+  "postcss.config.mjs",
+  "postcss.config.cjs"
+]), FRAMEWORK_BOUNDARY_FILE_PATTERNS = [
+  /^middleware\.[cm]?[jt]sx?$/,
+  /^route\.[cm]?[jt]sx?$/,
+  /^instrumentation(?:\.[\w-]+)?\.[cm]?[jt]sx?$/,
+  /^proxy\.[cm]?[jt]sx?$/,
+  /^next\.config\./
+];
+function isFrameworkBoundaryFile(name) {
+  return FRAMEWORK_BOUNDARY_FILE_PATTERNS.some((pattern) => pattern.test(name));
+}
+function isReservedFrameworkPath(path) {
+  let segments = path.split("/"), name = segments.at(-1) ?? path;
+  return segments.some((segment) => RESERVED_DIRECTORIES.has(segment)) || RESERVED_FILES.has(name) || isFrameworkBoundaryFile(name) || /^(?:loading|error|not-found)\.[cm]?[jt]sx?$/.test(name);
+}
+function isSourceCssPath(path) {
+  return path.endsWith(".css") && (!path.includes("/") || path.startsWith("css/"));
+}
+function isApprovedGroupPath(path, folder) {
+  if (!folder || !path.startsWith(`${folder}/`)) return !1;
+  let localPath = path.slice(folder.length + 1), groupName = folder.split("/").at(-1)?.replace(/^\((.*)\)$/, "$1");
+  return localPath === `${groupName}.config.json` || RENDERER_FILES.has(localPath) || isSourceCssPath(localPath) || localPath.startsWith("content/");
+}
+function isApprovedPublishOsPath(path, groupFolders) {
+  return ROOT_FILES.has(path) || RENDERER_FILES.has(path) || isSourceCssPath(path) || ROOT_DIRECTORIES.some((directory) => path.startsWith(directory)) || [...groupFolders].some((folder) => isApprovedGroupPath(path, folder));
+}
+
+export {
+  isSameOrDescendant,
+  isDescendant,
+  isOsMetadataPath,
+  isExcludedSourcePath,
+  isReservedFrameworkPath,
+  isApprovedPublishOsPath
+};

package/dist/compiler.d.ts

@@ -1,4 +1,15 @@
 type FrameworkOperation = "validate" | "compose" | "dev" | "build";
+type FrameworkPrivateComposition = {
+    appFiles: Array<{
+        path: string;
+        content: string;
+    }>;
+    publicPaths: string[];
+    sourceFiles: Array<{
+        path: string;
+        content: string;
+    }>;
+};
 type LocalOperationContext = {
     sourceRoot: string;
     sourceDir: string;
@@ -6,11 +17,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 +37,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 +61,17 @@ 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. */
+        /** Optional generated editor support for the selected framework. */
         ide?: {
             finalSourceRoot?: string;
         };
         /** Local development origin, supplied after selecting an available port. */
         previewUrl?: string;
-    };
-    consent?: {
-        installation?: boolean;
-        composition?: boolean;
+        /** App files supplied by a local maintainer launcher for checkout Dev. */
+        privateComposition?: FrameworkPrivateComposition;
     };
     port?: number;
+    portExplicit?: boolean;
 };
 type FrameworkDiagnostic = {
     code: string;
@@ -58,6 +81,9 @@ type FrameworkDiagnostic = {
     line?: number;
     column?: number;
     correction?: string;
+    sourceLine?: string;
+    length?: number;
+    propertyPath?: string;
 };
 type FrameworkGate = {
     id: string;
@@ -67,11 +93,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;
@@ -83,6 +121,7 @@ type FrameworkResult = {
         code: string;
         message: string;
         fix: string;
+        details?: Record<string, unknown>;
     };
 };
 type RunFrameworkOptions = {
@@ -92,9 +131,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 };