@postxl/generator 1.6.0 → 1.6.2

package/dist/helpers/package-json.generator.d.ts

@@ -3,7 +3,7 @@ import { PackageName } from './branded.types';
  * Hardcoded pnpm version used across all generated projects.
  * Update this when upgrading pnpm.
  */
-export declare const PNPM_VERSION = "10.30.2";
+export declare const PNPM_VERSION = "10.33.2";
 /**
  * Hardcoded Node.js version used across all generated projects.
  * Update this when upgrading Node.js.

package/dist/helpers/package-json.generator.js

@@ -7,7 +7,7 @@ exports.generatePackageJson = generatePackageJson;
  * Hardcoded pnpm version used across all generated projects.
  * Update this when upgrading pnpm.
  */
-exports.PNPM_VERSION = '10.30.2';
+exports.PNPM_VERSION = '10.33.2';
 /**
  * Hardcoded Node.js version used across all generated projects.
  * Update this when upgrading Node.js.

package/dist/utils/index.d.ts

@@ -1,7 +1,9 @@
+export * from './checksum';
 export * from './classify-path';
 export * from './custom-blocks';
 export * from './jsdoc';
 export * from './lint';
+export * from './lockfile';
 export * from './path';
 export * from './promise';
 export * from './prettier';

package/dist/utils/index.js

@@ -14,10 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./checksum"), exports);
 __exportStar(require("./classify-path"), exports);
 __exportStar(require("./custom-blocks"), exports);
 __exportStar(require("./jsdoc"), exports);
 __exportStar(require("./lint"), exports);
+__exportStar(require("./lockfile"), exports);
 __exportStar(require("./path"), exports);
 __exportStar(require("./promise"), exports);
 __exportStar(require("./prettier"), exports);

package/dist/utils/lockfile.d.ts

@@ -24,7 +24,7 @@ export type EjectedSentinel = typeof EJECTED_SENTINEL;
  * checksum, or the {@link EJECTED_SENTINEL} marking the file as permanently ejected.
  */
 export type LockEntry = Checksum | EjectedSentinel;
-declare const zLockFile: z.ZodPipe<z.ZodRecord<z.core.$ZodBranded<z.ZodString, "PXL.PosixPath", "out">, z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "PXL.Checksum", "out">, z.ZodLiteral<"ejected">]>>, z.ZodTransform<Map<string & z.core.$brand<"PXL.PosixPath">, LockEntry>, Record<string & z.core.$brand<"PXL.PosixPath">, "ejected" | (string & z.core.$brand<"PXL.Checksum">)>>>;
+declare const zLockFile: z.ZodPipe<z.ZodRecord<z.core.$ZodBranded<z.ZodString, "PXL.PosixPath", "out">, z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "PXL.Checksum", "out">, z.ZodLiteral<"ejected">]>>, z.ZodTransform<Map<string & z.core.$brand<"PXL.PosixPath">, LockEntry>, Record<string & z.core.$brand<"PXL.PosixPath">, (string & z.core.$brand<"PXL.Checksum">) | "ejected">>>;
 type LockFile = z.infer<typeof zLockFile>;
 export declare function isEjected(entry: LockEntry | undefined): entry is EjectedSentinel;
 export declare function writeLockFile(lockFilePath: string, vfs: VirtualFileSystem, opts?: {

package/dist/utils/sync.d.ts

@@ -75,6 +75,14 @@ type SyncParams = {
      * generation via `-m <names...>`.
      */
     selectiveGeneration?: boolean;
+    /**
+     * When true, computes the actions that *would* be performed but skips
+     * executing them — no files are written, deleted, or merge-conflict-marked,
+     * and the lock file is left untouched. The returned `SyncResults` still
+     * report the planned `action` per file, so callers can use
+     * `logSyncResult` to summarize the diff.
+     */
+    dryRun?: boolean;
 };
 /**
  * Error returned when files with unresolved merge conflicts are detected
@@ -117,7 +125,7 @@ export type SyncResults = {
  * merge conflict markers. If found, the sync will abort immediately and return an error with the
  * list of files that need to be resolved before generation can continue.
  */
-export declare function sync({ vfs, lockFilePath, diskFilePath, force, selectiveGeneration, }: SyncParams): Promise<SyncResults>;
+export declare function sync({ vfs, lockFilePath, diskFilePath, force, selectiveGeneration, dryRun, }: SyncParams): Promise<SyncResults>;
 type FileState = {
     state: 'empty';
 } | {

package/dist/utils/sync.js

@@ -121,7 +121,7 @@ const Path = __importStar(require("./path"));
  * merge conflict markers. If found, the sync will abort immediately and return an error with the
  * list of files that need to be resolved before generation can continue.
  */
-async function sync({ vfs, lockFilePath, diskFilePath, force, selectiveGeneration, }) {
+async function sync({ vfs, lockFilePath, diskFilePath, force, selectiveGeneration, dryRun, }) {
     const diskPathNormalized = Path.normalize(diskFilePath);
     const files = await getFilesStates({ vfs, lockFilePath, diskFilePath, selectiveGeneration: !!selectiveGeneration });
     // Check for unresolved merge conflicts before writing any files
@@ -156,6 +156,16 @@ async function sync({ vfs, lockFilePath, diskFilePath, force, selectiveGeneratio
             continue;
         }
         const [action, isEjectedFile] = determineActionState({ virtual, lock, disk }, force);
+        if (dryRun) {
+            // Dry-run: record the planned action but do not touch disk.
+            result.files[filePath] = {
+                action,
+                inputState,
+                actionResult: utils_1.Result.ok(undefined),
+                isEjected: isEjectedFile,
+            };
+            continue;
+        }
         const task = limit(async () => {
             const actionResult = await executeAction(Path.join(diskPathNormalized, filePath), action);
             if (actionResult.isErr()) {
@@ -165,7 +175,9 @@ async function sync({ vfs, lockFilePath, diskFilePath, force, selectiveGeneratio
         });
         tasks.push(task);
     }
-    tasks.push(limit(() => (0, lockfile_1.writeLockFile)(lockFilePath, vfs, selectiveGeneration ? { selectiveGeneration: true } : {})));
+    if (!dryRun) {
+        tasks.push(limit(() => (0, lockfile_1.writeLockFile)(lockFilePath, vfs, selectiveGeneration ? { selectiveGeneration: true } : {})));
+    }
     await Promise.all(tasks);
     return { success: true, ...result };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postxl/generator",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Core package that orchestrates the code generation of a PXL project",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -38,16 +38,16 @@
     "directory": "packages/generator"
   },
   "dependencies": {
-    "@typescript-eslint/eslint-plugin": "8.56.1",
-    "prettier": "3.8.1",
+    "@typescript-eslint/eslint-plugin": "8.59.2",
+    "prettier": "3.8.3",
     "diff": "8.0.3",
     "globals": "16.5.0",
     "isbinaryfile": "5.0.7",
     "jszip": "3.10.1",
-    "minimatch": "^10.2.2",
+    "minimatch": "^10.2.5",
     "p-limit": "3.1.0",
-    "@postxl/schema": "^2.0.0",
-    "@postxl/utils": "^1.4.0"
+    "@postxl/schema": "^2.0.1",
+    "@postxl/utils": "^1.4.1"
   },
   "devDependencies": {
     "@types/diff": "8.0.0"