@pgpmjs/core 7.1.0 → 7.2.0

package/index.d.ts

@@ -13,13 +13,15 @@ export * from './workspace/minimal';
 export * from './core/template-scaffold';
 export * from './core/boilerplate-types';
 export * from './core/boilerplate-scanner';
-export * from './files';
+export * from '@pgpmjs/ast/files';
+export * from '@pgpmjs/ast/module';
+export * from './bundle';
 export * from './refactor';
 export { cleanSql } from './migrate/clean';
 export { PgpmMigrate } from './migrate/client';
 export { PgpmInit } from './init/client';
 export * from './roles';
-export { parseAuthor } from './utils/author';
+export { parseAuthor } from '@pgpmjs/ast';
 export { DeployOptions, DeployResult, MigrateChange, MigratePlanFile, RevertOptions, RevertResult, StatusResult, VerifyOptions, VerifyResult } from './migrate/types';
 export { hashFile, hashString } from './migrate/utils/hash';
 export { executeQuery, TransactionContext, TransactionOptions, withTransaction } from './migrate/utils/transaction';

package/index.js

@@ -30,8 +30,10 @@ __exportStar(require("./workspace/minimal"), exports);
 __exportStar(require("./core/template-scaffold"), exports);
 __exportStar(require("./core/boilerplate-types"), exports);
 __exportStar(require("./core/boilerplate-scanner"), exports);
-// Export package-files functionality (now integrated into core)
-__exportStar(require("./files"), exports);
+// Re-export the module AST layer (moved to the @pgpmjs/ast leaf package)
+__exportStar(require("@pgpmjs/ast/files"), exports);
+__exportStar(require("@pgpmjs/ast/module"), exports);
+__exportStar(require("./bundle"), exports);
 __exportStar(require("./refactor"), exports);
 var clean_1 = require("./migrate/clean");
 Object.defineProperty(exports, "cleanSql", { enumerable: true, get: function () { return clean_1.cleanSql; } });
@@ -40,8 +42,8 @@ Object.defineProperty(exports, "PgpmMigrate", { enumerable: true, get: function
 var client_2 = require("./init/client");
 Object.defineProperty(exports, "PgpmInit", { enumerable: true, get: function () { return client_2.PgpmInit; } });
 __exportStar(require("./roles"), exports);
-var author_1 = require("./utils/author");
-Object.defineProperty(exports, "parseAuthor", { enumerable: true, get: function () { return author_1.parseAuthor; } });
+var ast_1 = require("@pgpmjs/ast");
+Object.defineProperty(exports, "parseAuthor", { enumerable: true, get: function () { return ast_1.parseAuthor; } });
 var hash_1 = require("./migrate/utils/hash");
 Object.defineProperty(exports, "hashFile", { enumerable: true, get: function () { return hash_1.hashFile; } });
 Object.defineProperty(exports, "hashString", { enumerable: true, get: function () { return hash_1.hashString; } });

package/migrate/client.js

@@ -6,7 +6,7 @@ const types_1 = require("@pgpmjs/types");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const pg_cache_1 = require("pg-cache");
-const files_1 = require("../files");
+const files_1 = require("@pgpmjs/ast/files");
 const deps_1 = require("../resolution/deps");
 const resolve_1 = require("../resolution/resolve");
 const clean_1 = require("./clean");

package/migrate/utils/hash.d.ts

@@ -1,11 +1,9 @@
+import { hashString } from '@pgpmjs/ast';
+export { hashString };
 /**
  * Generate SHA256 hash of a file's contents
  */
 export declare function hashFile(filePath: string): Promise<string>;
-/**
- * Generate SHA256 hash of a string
- */
-export declare function hashString(content: string): string;
 /**
  * Generate SHA256 hash of a SQL file's parsed and cleaned AST
  */

package/migrate/utils/hash.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashString = void 0;
 exports.hashFile = hashFile;
-exports.hashString = hashString;
 exports.hashSqlFile = hashSqlFile;
+const ast_1 = require("@pgpmjs/ast");
+Object.defineProperty(exports, "hashString", { enumerable: true, get: function () { return ast_1.hashString; } });
 const crypto_1 = require("crypto");
 const promises_1 = require("fs/promises");
 const pgsql_parser_1 = require("pgsql-parser");
@@ -14,12 +16,6 @@ async function hashFile(filePath) {
     const content = await (0, promises_1.readFile)(filePath, 'utf-8');
     return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
 }
-/**
- * Generate SHA256 hash of a string
- */
-function hashString(content) {
-    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
-}
 /**
  * Generate SHA256 hash of a SQL file's parsed and cleaned AST
  */
@@ -28,5 +24,5 @@ async function hashSqlFile(filePath) {
     const parsed = await (0, pgsql_parser_1.parse)(content);
     const cleaned = (0, package_1.cleanTree)(parsed);
     const astString = JSON.stringify(cleaned);
-    return hashString(astString);
+    return (0, ast_1.hashString)(astString);
 }

package/modules/modules.d.ts

@@ -1,4 +1,4 @@
-import { Module } from '../files';
+import { Module } from '@pgpmjs/ast/files';
 export type ModuleMap = Record<string, Module>;
 /**
  * Mapping from control file names (used in extensions list) to npm package names.

package/modules/modules.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getExtensionsAndModulesChanges = exports.getExtensionsAndModules = exports.latestChangeAndVersion = exports.latestChange = exports.getMissingInstallableModules = exports.PGPM_MODULE_MAP = void 0;
-const files_1 = require("../files");
+const files_1 = require("@pgpmjs/ast/files");
 const types_1 = require("@pgpmjs/types");
 /**
  * Mapping from control file names (used in extensions list) to npm package names.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgpmjs/core",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PGPM Package and Migration Tools",
   "main": "index.js",
@@ -48,6 +48,8 @@
     "makage": "^0.3.0"
   },
   "dependencies": {
+    "@pgpmjs/ast": "^0.1.0",
+    "@pgpmjs/bundle": "^0.1.0",
     "@pgpmjs/env": "^2.28.2",
     "@pgpmjs/logger": "^2.14.0",
     "@pgpmjs/server-utils": "^3.15.3",
@@ -64,5 +66,5 @@
     "pgsql-parser": "^18.1.1",
     "yanse": "^0.2.1"
   },
-  "gitHead": "370a4754d9ad8caaa1446ff2337a7fbcd6ea75a5"
+  "gitHead": "15a831fa029544068ee64e3386e4b08715d2b86d"
 }

package/packaging/package.js

@@ -6,7 +6,7 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const pgsql_deparser_1 = require("pgsql-deparser");
 const pgsql_parser_1 = require("pgsql-parser");
-const files_1 = require("../files");
+const files_1 = require("@pgpmjs/ast/files");
 const resolve_1 = require("../resolution/resolve");
 const transform_1 = require("./transform");
 const log = new logger_1.Logger('package');

package/rebundle/module.js

@@ -5,7 +5,7 @@ exports.mergeChunkScript = mergeChunkScript;
 exports.rebundleModule = rebundleModule;
 const fs_1 = require("fs");
 const path_1 = require("path");
-const parser_1 = require("../files/plan/parser");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
 const package_1 = require("../packaging/package");
 const slice_1 = require("../slice/slice");
 const rebundle_1 = require("./rebundle");

package/rebundle/rebundle.js

@@ -5,10 +5,10 @@ exports.assembleChunkSql = assembleChunkSql;
 exports.verifyRebundleInvariant = verifyRebundleInvariant;
 const fs_1 = require("fs");
 const path_1 = require("path");
-const parser_1 = require("../files/plan/parser");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
 const resolve_1 = require("../resolution/resolve");
 const slice_1 = require("../slice/slice");
-const parser_2 = require("../files/plan/parser");
+const parser_2 = require("@pgpmjs/ast/files/plan/parser");
 /**
  * Derive the boundary key for a change under the given strategy.
  * Consecutive changes sharing a key may be merged into the same chunk.

package/rebundle/types.d.ts

@@ -1,4 +1,4 @@
-import { Change } from '../files/types';
+import { Change } from '@pgpmjs/ast/files/types';
 import { SliceWarning } from '../slice/types';
 /**
  * Strategy for rebundling a module's changes into fewer, larger chunks.

package/rebundle/workspace.js

@@ -4,7 +4,7 @@ exports.rebundleWorkspace = rebundleWorkspace;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const template_scaffold_1 = require("../core/template-scaffold");
-const parser_1 = require("../files/plan/parser");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
 const package_1 = require("../packaging/package");
 const resolve_1 = require("../resolution/resolve");
 const minimal_1 = require("../workspace/minimal");

package/refactor/rename.d.ts

@@ -1,3 +1,5 @@
+import { renameInPlanContent } from '@pgpmjs/ast/plan-rename';
+export { renameInPlanContent };
 /**
  * Options for {@link renameChanges}.
  */
@@ -29,14 +31,6 @@ export interface RenameChangesResult {
  * @throws on any violation.
  */
 export declare function validateRenames(moduleDir: string, renames: Map<string, string>): void;
-/**
- * Rewrite change names in a pgpm.plan's content according to a rename map.
- * Textual and format-preserving: only the change-name token at the start of a
- * change line, plain (same-package) dependency refs inside `[...]`, and tag
- * lines' change field are rewritten; timestamps, planners, comments,
- * cross-package refs, and tag refs are untouched.
- */
-export declare function renameInPlanContent(content: string, renames: Map<string, string>): string;
 /**
  * Atomically rename/move changes within a pgpm module: the coupled 4-way
  * rewrite of (1) deploy/revert/verify script files on disk, (2) the moved

package/refactor/rename.js

@@ -1,13 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.renameInPlanContent = void 0;
 exports.validateRenames = validateRenames;
-exports.renameInPlanContent = renameInPlanContent;
 exports.renameChanges = renameChanges;
 exports.deriveRenamesFromSchemaMapping = deriveRenamesFromSchemaMapping;
 const fs_1 = require("fs");
 const path_1 = require("path");
-const parser_1 = require("../files/plan/parser");
-const header_1 = require("../files/sql/header");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
+const header_1 = require("@pgpmjs/ast/files/sql/header");
+const plan_rename_1 = require("@pgpmjs/ast/plan-rename");
+Object.defineProperty(exports, "renameInPlanContent", { enumerable: true, get: function () { return plan_rename_1.renameInPlanContent; } });
 const SCRIPT_DIRS = ['deploy', 'revert', 'verify'];
 function escapeRe(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -65,31 +67,6 @@ function validateRenames(moduleDir, renames) {
         targets.add(to);
     }
 }
-/**
- * Rewrite change names in a pgpm.plan's content according to a rename map.
- * Textual and format-preserving: only the change-name token at the start of a
- * change line, plain (same-package) dependency refs inside `[...]`, and tag
- * lines' change field are rewritten; timestamps, planners, comments,
- * cross-package refs, and tag refs are untouched.
- */
-function renameInPlanContent(content, renames) {
-    const froms = Array.from(renames.keys()).sort((a, b) => b.length - a.length);
-    return content
-        .split('\n')
-        .map(line => {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('%'))
-            return line;
-        let result = line;
-        for (const from of froms) {
-            const to = renames.get(from);
-            const re = new RegExp(`(^|[\\s\\[])${escapeRe(from)}(?=$|[\\s\\]@])`, 'g');
-            result = result.replace(re, `$1${to}`);
-        }
-        return result;
-    })
-        .join('\n');
-}
 /**
  * Atomically rename/move changes within a pgpm module: the coupled 4-way
  * rewrite of (1) deploy/revert/verify script files on disk, (2) the moved
@@ -163,7 +140,7 @@ function renameChanges(moduleDir, renames, options = {}) {
     // 4. Rewrite pgpm.plan
     const planPath = (0, path_1.join)(moduleDir, 'pgpm.plan');
     const planContent = (0, fs_1.readFileSync)(planPath, 'utf-8');
-    const newPlanContent = renameInPlanContent(planContent, renames);
+    const newPlanContent = (0, plan_rename_1.renameInPlanContent)(planContent, renames);
     if (newPlanContent !== planContent) {
         if (dryRun) {
             result.dryRunReport.push('Would rewrite: pgpm.plan');

package/resolution/deps.d.ts

@@ -1,4 +1,4 @@
-import { ExtendedPlanFile } from '../files/types';
+import { ExtendedPlanFile } from '@pgpmjs/ast/files/types';
 /**
  * Represents a dependency graph where keys are module identifiers
  * and values are arrays of their direct dependencies

package/resolution/deps.js

@@ -5,8 +5,8 @@ const fs_1 = require("fs");
 const glob_1 = require("glob");
 const path_1 = require("path");
 const pgpm_1 = require("../core/class/pgpm");
-const parser_1 = require("../files/plan/parser");
-const header_1 = require("../files/sql/header");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
+const header_1 = require("@pgpmjs/ast/files/sql/header");
 const types_1 = require("@pgpmjs/types");
 /**
  * Core dependency resolution algorithm that handles circular dependency detection

package/resolution/resolve.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveTagToChangeName = exports.resolveWithPlan = exports.resolve = void 0;
 const fs_1 = require("fs");
-const files_1 = require("../files");
-const parser_1 = require("../files/plan/parser");
+const files_1 = require("@pgpmjs/ast/files");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
 const deps_1 = require("./deps");
 const types_1 = require("@pgpmjs/types");
 /**

package/slice/slice.d.ts

@@ -1,4 +1,4 @@
-import { Change, Tag, ExtendedPlanFile } from '../files/types';
+import { Change, Tag, ExtendedPlanFile } from '@pgpmjs/ast/files/types';
 import { SliceConfig, SliceResult, DependencyGraph, PackageOutput, GroupingStrategy, PatternStrategy, CrossPackageDepMode } from './types';
 /**
  * Build a dependency graph from a parsed plan file

package/slice/slice.js

@@ -14,7 +14,7 @@ exports.generatePlanContent = generatePlanContent;
 exports.generateControlContent = generateControlContent;
 exports.generateSinglePackage = generateSinglePackage;
 exports.slicePlan = slicePlan;
-const parser_1 = require("../files/plan/parser");
+const parser_1 = require("@pgpmjs/ast/files/plan/parser");
 const minimatch_1 = require("minimatch");
 /**
  * Build a dependency graph from a parsed plan file

package/slice/types.d.ts

@@ -1,4 +1,4 @@
-import { Change, Tag, ExtendedPlanFile } from '../files/types';
+import { Change, Tag, ExtendedPlanFile } from '@pgpmjs/ast/files/types';
 /**
  * Configuration for slicing a plan into multiple packages
  */

package/workspace/minimal.d.ts

@@ -1,4 +1,4 @@
-import { Change, Tag } from '../files/types';
+import { Change, Tag } from '@pgpmjs/ast/files/types';
 declare const SCRIPT_DIRS: readonly ["deploy", "revert", "verify"];
 export type MinimalScriptDir = (typeof SCRIPT_DIRS)[number];
 /**

package/esm/files/extension/index.js

@@ -1,3 +0,0 @@
-// Re-export all extension functionality
-export * from './reader';
-export * from './writer';

package/esm/files/extension/reader.js

@@ -1,79 +0,0 @@
-import { readFileSync } from 'fs';
-import { basename, dirname, relative } from 'path';
-import { parsePlanFileSimple } from '../plan';
-/**
- * Parse a .control file and extract its metadata.
- * https://www.postgresql.org/docs/current/extend-extensions.html
- */
-export function parseControlFile(filePath, basePath) {
-    const contents = readFileSync(filePath, 'utf-8');
-    const key = basename(filePath).split('.control')[0];
-    const requires = contents
-        .split('\n')
-        .find((line) => /^requires/.test(line))
-        ?.split('=')[1]
-        .split(',')
-        .map((req) => req.replace(/[\'\s]*/g, '').trim()) || [];
-    const version = contents
-        .split('\n')
-        .find((line) => /^default_version/.test(line))
-        ?.split('=')[1]
-        .replace(/[\']*/g, '')
-        .trim() || '';
-    return {
-        path: dirname(relative(basePath, filePath)),
-        requires,
-        version,
-    };
-}
-/**
- * Parse the pgpm.plan file to get the extension name.
- */
-export const getExtensionName = (packageDir) => {
-    const planPath = `${packageDir}/pgpm.plan`;
-    const plan = parsePlanFileSimple(planPath);
-    if (!plan.package) {
-        throw new Error('No package name found in pgpm.plan!');
-    }
-    return plan.package;
-};
-/**
- * Get detailed information about an extension in the specified directory.
- */
-export const getExtensionInfo = (packageDir) => {
-    const pkgPath = `${packageDir}/package.json`;
-    const pkg = require(pkgPath);
-    const extname = getExtensionName(packageDir);
-    const version = pkg.version;
-    const Makefile = `${packageDir}/Makefile`;
-    const controlFile = `${packageDir}/${extname}.control`;
-    const sqlFile = `sql/${extname}--${version}.sql`;
-    return { extname, packageDir, version, Makefile, controlFile, sqlFile };
-};
-/**
- * Get a list of extensions required by an extension from its control file.
- * Returns an empty array if the file doesn't exist or has no requires line.
- */
-export const getInstalledExtensions = (controlFilePath) => {
-    try {
-        const contents = readFileSync(controlFilePath, 'utf-8');
-        const match = contents.match(/^\s*requires\s*=\s*'([^']*)'/m);
-        if (!match) {
-            return [];
-        }
-        const requiresValue = match[1];
-        if (!requiresValue || requiresValue.trim() === '') {
-            return [];
-        }
-        return requiresValue
-            .split(',')
-            .map((ext) => ext.trim())
-            .filter((ext) => ext.length > 0);
-    }
-    catch (e) {
-        if (e.code === 'ENOENT') {
-            return [];
-        }
-        throw new Error(`Error reading control file at ${controlFilePath}: ${e.message}`);
-    }
-};

package/esm/files/extension/writer.js

@@ -1,99 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from 'fs';
-import { getExtensionInfo } from './reader';
-/**
- * Write the Makefile for the extension.
- */
-export const writeExtensionMakefile = (outputPath, extname, version) => {
-    const content = `EXTENSION = ${extname}
-DATA = sql/${extname}--${version}.sql
-
-PG_CONFIG = pg_config
-PGXS := $(shell $(PG_CONFIG) --pgxs)
-include $(PGXS)
-  `;
-    writeFileSync(outputPath, content);
-};
-/**
- * Generate content for a .control file
- * https://www.postgresql.org/docs/current/extend-extensions.html
- */
-export function generateControlFileContent(options) {
-    const { name, version, comment = `${name} extension`, requires = [], default_version = version, relocatable = false, superuser = false, schema, module_pathname } = options;
-    let content = `# ${name} extension
-comment = '${comment}'
-default_version = '${default_version}'
-`;
-    if (module_pathname) {
-        content += `module_pathname = '${module_pathname}'\n`;
-    }
-    else {
-        content += `module_pathname = '$libdir/${name}'\n`;
-    }
-    if (requires.length > 0) {
-        content += `requires = '${requires.join(',')}'\n`;
-    }
-    content += `relocatable = ${relocatable}
-superuser = ${superuser}\n`;
-    if (schema) {
-        content += `schema = ${schema}\n`;
-    }
-    return content;
-}
-/**
- * Update (or insert/remove) the `requires =` line of an existing .control file
- * in place, preserving every other field and the file's formatting. Used when
- * changing a module's dependencies after init (e.g. via `pgpm extension`) so
- * hand-tuned fields (comment, schema, relocatable, module_pathname) survive.
- */
-export function upsertRequiresLine(content, requires) {
-    const lines = content.split('\n');
-    const idx = lines.findIndex((line) => /^\s*requires\s*=/.test(line));
-    if (requires.length === 0) {
-        if (idx !== -1)
-            lines.splice(idx, 1);
-        return lines.join('\n');
-    }
-    const requiresLine = `requires = '${requires.join(',')}'`;
-    if (idx !== -1) {
-        lines[idx] = requiresLine;
-        return lines.join('\n');
-    }
-    // Insert to match generated ordering (before relocatable/superuser/schema).
-    const insertAt = lines.findIndex((line) => /^\s*(relocatable|superuser|schema)\s*=/.test(line));
-    if (insertAt !== -1) {
-        lines.splice(insertAt, 0, requiresLine);
-    }
-    else {
-        lines.push(requiresLine);
-    }
-    return lines.join('\n');
-}
-/**
- * Write the control file for the extension.
- * If the file already exists, only its `requires` line is updated so that any
- * custom fields are preserved; otherwise a fresh file is generated.
- */
-export const writeExtensionControlFile = (outputPath, extname, extensions, version) => {
-    if (existsSync(outputPath)) {
-        const existing = readFileSync(outputPath, 'utf-8');
-        writeFileSync(outputPath, upsertRequiresLine(existing, extensions));
-        return;
-    }
-    const content = generateControlFileContent({
-        name: extname,
-        version,
-        requires: extensions
-    });
-    writeFileSync(outputPath, content);
-};
-/**
- * Write control and Makefile for the extension with given data.
- * If extInfo is not provided, it will be generated from packageDir.
- */
-export const writeExtensions = (packageDir, extensions, extInfo) => {
-    // If extInfo is not provided, get it from packageDir
-    const info = extInfo || getExtensionInfo(packageDir);
-    const { controlFile, Makefile, extname, version } = info;
-    writeExtensionControlFile(controlFile, extname, extensions, version);
-    writeExtensionMakefile(Makefile, extname, version);
-};

package/esm/files/index.js

@@ -1,6 +0,0 @@
-// Re-export all functionality from package-files
-export * from './extension';
-export * from './plan';
-export * from './sql';
-export * from './sql-scripts';
-export * from './types';

package/esm/files/plan/generator.js

@@ -1,82 +0,0 @@
-import fs from 'fs';
-/**
- * Fixed epoch timestamp used for deterministic plan generation.
- * Can be overridden with the PGPM_FROZEN_TIME environment variable.
- */
-const DEFAULT_FROZEN_TIME = '2017-08-11T08:11:51Z';
-/**
- * Get a UTC timestamp string from a Date object.
- */
-function getUTCTimestamp(d) {
-    return (d.getUTCFullYear() +
-        '-' + String(d.getUTCMonth() + 1).padStart(2, '0') +
-        '-' + String(d.getUTCDate()).padStart(2, '0') +
-        'T' + String(d.getUTCHours()).padStart(2, '0') +
-        ':' + String(d.getUTCMinutes()).padStart(2, '0') +
-        ':' + String(d.getUTCSeconds()).padStart(2, '0') +
-        'Z');
-}
-/**
- * Get a timestamp for the plan file.
- * Uses the PGPM_FROZEN_TIME env var if present, otherwise the fixed epoch.
- */
-export function getNow() {
-    const frozen = process.env.PGPM_FROZEN_TIME;
-    if (frozen) {
-        return getUTCTimestamp(new Date(frozen));
-    }
-    return DEFAULT_FROZEN_TIME;
-}
-/**
- * Sort dependencies by their order in the supplied plan, so prerequisites
- * (parent migrations) appear before their dependents in the bracket.
- * Internal dependencies are sorted by their plan index, and external
- * dependencies (not in the plan) preserve their original order.
- */
-const sortDependencies = (deps, order) => {
-    const originalOrder = new Map(deps.map((dep, index) => [dep, index]));
-    return [...deps].sort((a, b) => {
-        const aIndex = order.get(a);
-        const bIndex = order.get(b);
-        const aOriginal = originalOrder.get(a);
-        const bOriginal = originalOrder.get(b);
-        if (aIndex !== undefined && bIndex !== undefined)
-            return aIndex - bIndex || aOriginal - bOriginal;
-        if (aIndex !== undefined)
-            return -1;
-        if (bIndex !== undefined)
-            return 1;
-        return aOriginal - bOriginal;
-    });
-};
-/**
- * Generate a plan file content from structured data
- */
-export function generatePlan(options) {
-    const { moduleName, uri, entries } = options;
-    const now = getNow();
-    const planfile = [
-        `%syntax-version=1.0.0`,
-        `%project=${moduleName}`,
-        `%uri=${uri || moduleName}`
-    ];
-    // Build an order map from the entry list so brackets can be sorted by plan order
-    const entryOrder = new Map(entries.map((entry, index) => [entry.change, index]));
-    // Generate the plan entries
-    entries.forEach(entry => {
-        const deps = sortDependencies(entry.dependencies || [], entryOrder);
-        if (deps.length > 0) {
-            planfile.push(`${entry.change} [${deps.join(' ')}] ${now} constructive <constructive@5b0c196eeb62>${entry.comment ? ` # ${entry.comment}` : ''}`);
-        }
-        else {
-            planfile.push(`${entry.change} ${now} constructive <constructive@5b0c196eeb62>${entry.comment ? ` # ${entry.comment}` : ''}`);
-        }
-    });
-    return planfile.join('\n');
-}
-/**
- * Write a generated plan file to disk
- */
-export function writePlan(planPath, plan) {
-    fs.writeFileSync(planPath, plan);
-}

package/esm/files/plan/index.js

@@ -1,5 +0,0 @@
-// Re-export all plan functionality
-export * from './generator';
-export * from './parser';
-export * from './validators';
-export * from './writer';