@codefast/cli 0.8.1 → 0.10.0

package/dist/mirror/domain/types.d.ts

@@ -0,0 +1,131 @@
+import type { GlobalCliOptions } from "#/core/cli/global-options";
+import type { CodefastConfig } from "#/core/config/schema";
+/**
+ * One conditional exports entry, keyed by resolution condition.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface ExportEntry {
+    source?: string;
+    types?: string;
+    import?: string;
+    require?: string;
+}
+/**
+ * Final `package.json#exports` map (conditional exports + string shims + `./package.json`).
+ *
+ * @since 0.3.16-canary.0
+ */
+export type ExportMapData = Record<string, ExportEntry | string>;
+/**
+ * The pre-transform `dist/` path for each generated export specifier.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type ExportOriginalPathBySpecifier = Record<string, string>;
+interface DistModuleFiles {
+    js: string | null;
+    mjs: string | null;
+    cjs: string | null;
+    dts: string | null;
+}
+/**
+ * A `dist/` module path together with the build files found for it.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface DistModule {
+    path: string;
+    files: DistModuleFiles;
+}
+/**
+ * Parsed `package.json` — only fields mirror reads/writes are typed strictly.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type PackageJsonShape = {
+    name?: unknown;
+    exports?: unknown;
+    [key: string]: unknown;
+};
+/**
+ * A generated exports map with its specifier origins and asset counts.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface GenerateExportsResult {
+    exports: ExportMapData;
+    originalPathBySpecifier: ExportOriginalPathBySpecifier;
+    jsCount: number;
+    cssCount: number;
+}
+/**
+ * Per-package outcome of a mirror run, as reported in progress and JSON output.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface PackageStats {
+    name: string;
+    path: string;
+    jsModules: number;
+    cssExports: number;
+    extraExports: number;
+    totalExports: number;
+    hasTransform: boolean;
+    cssConfigStatus: "disabled" | "configured" | "";
+    skipped: boolean;
+    skipReason: string;
+    error: string | null;
+    prunedExportKeys: Array<string>;
+}
+/**
+ * Built dist assets tallied for one package (reporter / progress output).
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface MirrorDistAssetCounts {
+    jsCount: number;
+    cssCount: number;
+}
+/**
+ * Aggregate totals across every package in a mirror run.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface GlobalStats {
+    packagesFound: number;
+    packagesProcessed: number;
+    packagesSkipped: number;
+    packagesErrored: number;
+    totalExports: number;
+    totalJsModules: number;
+    totalCssExports: number;
+    packageDetails: Array<PackageStats>;
+}
+/**
+ * How workspace packages were resolved when scanning the repo (for logging / UX).
+ *
+ * @since 0.3.16-canary.0
+ */
+export type WorkspaceMultiDiscoverySource = "default-patterns" | "pnpm-workspace-yaml" | "declared-empty" | "single-package";
+/**
+ * The workspace package paths found for a mirror run and how they were discovered.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type FindWorkspacePackagesResult = {
+    relPaths: Array<string>;
+    multiSource: WorkspaceMultiDiscoverySource;
+};
+/**
+ * Everything the `mirror` action needs resolved before a run: globals, root, config, and filter.
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface MirrorSyncCommandPrelude {
+    readonly globals: GlobalCliOptions;
+    readonly rootDir: string;
+    readonly config: CodefastConfig;
+    readonly packageFilter: string | undefined;
+}
+export {};

package/dist/mirror/output.d.ts

@@ -0,0 +1,23 @@
+import type { GlobalStats, PackageStats } from "#/mirror/domain/types";
+import type { MirrorProcessingModeInput } from "#/mirror/sync-reporter";
+import type { MirrorSyncProgressListener } from "#/mirror/sync-types";
+/**
+ * A progress listener that renders mirror run events through the CLI reporter.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare class MirrorSyncProgressPresenter implements MirrorSyncProgressListener {
+    private readonly reporter;
+    private verbose;
+    private dryRun;
+    configure(options: {
+        readonly noColor: boolean;
+        readonly verbose: boolean;
+        readonly dryRun: boolean;
+    }): void;
+    onBanner(): void;
+    onProcessingMode(mode: MirrorProcessingModeInput): void;
+    onNoPackages(): void;
+    onPackageComplete(pkgStats: PackageStats, ordinal: number, total: number): void;
+    onComplete(stats: GlobalStats, elapsedSeconds: number): void;
+}

package/dist/mirror/package-path.d.ts

@@ -0,0 +1,19 @@
+import { AppError } from "#/core/errors";
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Result } from "#/core/result";
+/**
+ * Resolves the optional positional package argument to a root-relative path, or `undefined` when absent.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function resolveMirrorPackageFromCliArg(fs: FilesystemPort, args: {
+    readonly rootDir: string;
+    readonly packageArg: string | undefined;
+    readonly currentWorkingDirectory: string;
+}): Result<string | undefined, AppError>;
+/**
+ * Resolves a package filter to a root-relative path, rejecting anything outside the monorepo root.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function resolvePackageFilterUnderRoot(fs: FilesystemPort, rootDir: string, packageFilter: string): Result<string, AppError>;

package/dist/mirror/prepare.d.ts

@@ -0,0 +1,15 @@
+import type { GlobalCliOptions } from "#/core/cli/global-options";
+import { AppError } from "#/core/errors";
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Result } from "#/core/result";
+import type { MirrorSyncCommandPrelude } from "#/mirror/domain/types";
+/**
+ * Resolves the repo root, config, and package filter into the prelude a mirror run starts from.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function prepareMirrorSync(fs: FilesystemPort, args: {
+    readonly currentWorkingDirectory: string;
+    readonly packageArg: string | undefined;
+    readonly globals: GlobalCliOptions;
+}): Promise<Result<MirrorSyncCommandPrelude, AppError>>;

package/dist/mirror/prepare.js

@@ -2,7 +2,7 @@ import { loadCodefastConfig } from "#/core/config";
 import { AppError } from "#/core/errors";
 import { messageFrom } from "#/core/errors";
 import { err, ok } from "#/core/result";
-import { findRepoRoot } from "#/core/workspace/resolver";
+import { resolveProjectRoot } from "#/core/workspace/resolver";
 import { resolveMirrorPackageFromCliArg } from "#/mirror/package-path";
 /**
  * Resolves the repo root, config, and package filter into the prelude a mirror run starts from.
@@ -12,7 +12,7 @@ import { resolveMirrorPackageFromCliArg } from "#/mirror/package-path";
 export async function prepareMirrorSync(fs, args) {
     let rootDir;
     try {
-        rootDir = findRepoRoot(args.currentWorkingDirectory, fs);
+        rootDir = resolveProjectRoot(args.currentWorkingDirectory, fs).rootDir;
     }
     catch (caughtError) {
         return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));

package/dist/mirror/supplement-exports.d.ts

@@ -0,0 +1,27 @@
+import type { FilesystemPort } from "#/core/filesystem/port";
+/**
+ * The export specifiers a preserve-mode run added conditions to.
+ *
+ * @since 0.3.16-canary.3
+ */
+export type SupplementResult = {
+    supplementedSpecifiers: Array<string>;
+};
+/**
+ * Adds missing conditions to a package's existing exports map and returns the specifiers it touched.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function supplementExportsInPackageJson(fs: FilesystemPort, packageJsonPath: string, packageDir: string, options: {
+    source: boolean | string;
+    types: boolean;
+    import: boolean;
+    resolveSourcePath: (modulePath: string) => string;
+}, write?: boolean): Promise<SupplementResult>;
+/**
+ * Builds a `resolveSourcePath` closure that checks the filesystem for `.tsx` before
+ * falling back to `.ts`. Mirrors the logic used in normal (non-custom) mode.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function buildSourcePathResolver(fs: FilesystemPort, packageDir: string): (modulePath: string) => string;

package/dist/mirror/supplement-exports.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { DIST_DIR } from "#/mirror/domain/constants";
+import { distDirName } from "#/core/workspace/well-known-files";
 import { writePackageJsonExportsAtomic } from "#/mirror/write-exports";
 const DTS_EXTENSIONS = [".d.mts", ".d.ts", ".d.cts"];
 const JS_EXTENSIONS = [".mjs", ".js"];
@@ -116,7 +116,7 @@ export async function supplementExportsInPackageJson(fs, packageJsonPath, packag
     if (!existingExports || typeof existingExports !== "object" || Array.isArray(existingExports)) {
         return { supplementedSpecifiers: [] };
     }
-    const distDir = path.join(packageDir, DIST_DIR);
+    const distDir = path.join(packageDir, distDirName);
     const supplementedSpecifiers = [];
     const supplementedExports = {};
     const originalPathBySpecifier = {};

package/dist/mirror/sync-reporter.d.ts

@@ -0,0 +1,60 @@
+import type { GlobalStats, MirrorDistAssetCounts, PackageStats, WorkspaceMultiDiscoverySource } from "#/mirror/domain/types";
+/**
+ * Whether a run targets a single package or the discovered workspace set.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorProcessingModeInput = {
+    kind: "single";
+} | {
+    kind: "multi";
+    source: WorkspaceMultiDiscoverySource;
+};
+/**
+ * The stdout/stderr line-writer shape the reporter prints through.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type CliLoggerLike = {
+    out(line: string): void;
+    err(line: string): void;
+};
+/**
+ * The rendering surface for every message a mirror run prints.
+ *
+ * @since 0.3.16-canary.0
+ */
+interface MirrorSyncReporterPort {
+    configureMirrorColors(noColor: boolean): void;
+    mirrorBanner(logger: CliLoggerLike): void;
+    mirrorDryRunNotice(logger: CliLoggerLike): void;
+    mirrorProcessingMode(logger: CliLoggerLike, mode: MirrorProcessingModeInput): void;
+    mirrorNoPackages(logger: CliLoggerLike): void;
+    logSkippedWorkspacePackage(logger: CliLoggerLike, index: number, total: number, displayName: string, reason: string): void;
+    logPackageSuccess(logger: CliLoggerLike, index: number, total: number, pkgStats: PackageStats, generatedDistAssetCounts: MirrorDistAssetCounts, verbose: boolean): void;
+    logPrunedStaleExport(logger: CliLoggerLike, exportSpecifier: string): void;
+    logPackageError(logger: CliLoggerLike, index: number, total: number, displayName: string, errorValue: unknown, verbose: boolean): void;
+    mirrorSummarySeparator(logger: CliLoggerLike): void;
+    mirrorSummary(logger: CliLoggerLike, stats: GlobalStats, elapsedSeconds: number): void;
+}
+/**
+ * Console implementation: ANSI styling and layout for the mirror command.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare class MirrorSyncReporter implements MirrorSyncReporterPort {
+    private colorsAreEnabled;
+    configureMirrorColors(noColor: boolean): void;
+    mirrorBanner(logger: CliLoggerLike): void;
+    mirrorDryRunNotice(logger: CliLoggerLike): void;
+    mirrorProcessingMode(logger: CliLoggerLike, mode: MirrorProcessingModeInput): void;
+    mirrorNoPackages(logger: CliLoggerLike): void;
+    logSkippedWorkspacePackage(logger: CliLoggerLike, index: number, total: number, displayName: string, reason: string): void;
+    logPackageSuccess(logger: CliLoggerLike, index: number, total: number, pkgStats: PackageStats, generatedDistAssetCounts: MirrorDistAssetCounts, verbose: boolean): void;
+    logPrunedStaleExport(logger: CliLoggerLike, exportSpecifier: string): void;
+    logPackageError(logger: CliLoggerLike, index: number, total: number, displayName: string, errorValue: unknown, verbose: boolean): void;
+    mirrorSummarySeparator(logger: CliLoggerLike): void;
+    mirrorSummary(logger: CliLoggerLike, stats: GlobalStats, elapsedSeconds: number): void;
+    private paint;
+}
+export {};

package/dist/mirror/sync-reporter.js

@@ -42,6 +42,10 @@ export class MirrorSyncReporter {
             logger.out(`${this.paint("Discovering workspace packages from pnpm-workspace.yaml…", ANSI.dim)}\n`);
             return;
         }
+        if (mode.source === "single-package") {
+            logger.out(`${this.paint("No pnpm-workspace.yaml — processing the single package at the project root…", ANSI.dim)}\n`);
+            return;
+        }
         logger.out(`${this.paint("pnpm-workspace.yaml declares an empty workspace package list.", ANSI.dim)}\n`);
     }
     mirrorNoPackages(logger) {

package/dist/mirror/sync-types.d.ts

@@ -0,0 +1,43 @@
+import type { GlobalStats, PackageStats, WorkspaceMultiDiscoverySource } from "#/mirror/domain/types";
+/**
+ * The inputs a mirror run is invoked with.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorSyncRunRequest = {
+    rootDir: string;
+    packageFilter?: string | undefined;
+    config?: unknown;
+    /** When false, compute and report changes without writing package.json. Defaults to true. */
+    write?: boolean | undefined;
+};
+/**
+ * Callbacks a mirror run invokes as it progresses through packages.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorSyncProgressListener = {
+    configure(options: {
+        readonly noColor: boolean;
+        readonly verbose: boolean;
+        readonly dryRun: boolean;
+    }): void;
+    onBanner(): void;
+    onProcessingMode(mode: {
+        readonly kind: "single";
+    } | {
+        readonly kind: "multi";
+        readonly source: WorkspaceMultiDiscoverySource;
+    }): void;
+    onNoPackages(): void;
+    onPackageComplete(pkgStats: PackageStats, ordinal: number, total: number): void;
+    onComplete(stats: GlobalStats, elapsedSeconds: number): void;
+};
+/**
+ * A run request paired with an optional progress listener.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type MirrorSyncExecutionInput = MirrorSyncRunRequest & {
+    readonly listener?: MirrorSyncProgressListener | undefined;
+};

package/dist/mirror/sync-workspace-package.d.ts

@@ -0,0 +1,9 @@
+import type { MirrorConfig } from "#/core/config/schema";
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { PackageStats } from "#/mirror/domain/types";
+/**
+ * Regenerates one package's `package.json#exports` from its `dist/` and returns the package's stats.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function syncExportsForWorkspacePackage(fs: FilesystemPort, rootDir: string, packagePathStr: string, config: MirrorConfig, write?: boolean): Promise<PackageStats>;

package/dist/mirror/sync-workspace-package.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { messageFrom } from "#/core/errors";
+import { distDirName, packageJsonFileName } from "#/core/workspace/well-known-files";
 import { createMirrorDistFilesystem } from "#/mirror/dist-filesystem-impl";
-import { DIST_DIR, PACKAGE_JSON } from "#/mirror/domain/constants";
 import { createPathTransform, generateExports } from "#/mirror/domain/exports";
 import { resolvePackageDisplayName } from "#/mirror/domain/package-display-name";
 import { buildSourcePathResolver, supplementExportsInPackageJson } from "#/mirror/supplement-exports";
@@ -16,8 +16,8 @@ export async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr
     const pathResolve = path.resolve;
     const pathBasename = path.basename;
     const packageDir = pathResolve(rootDir, packagePathStr);
-    const distDir = pathJoin(packageDir, DIST_DIR);
-    const packageJsonPath = pathJoin(packageDir, PACKAGE_JSON);
+    const distDir = pathJoin(packageDir, distDirName);
+    const packageJsonPath = pathJoin(packageDir, packageJsonFileName);
     const folderBasename = pathBasename(packageDir);
     const distFilesystem = createMirrorDistFilesystem(fs);
     const pkgStats = {

package/dist/mirror/sync.d.ts

@@ -0,0 +1,12 @@
+import { AppError } from "#/core/errors";
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { Result } from "#/core/result";
+import type { GlobalStats } from "#/mirror/domain/types";
+import type { MirrorSyncExecutionInput } from "#/mirror/sync-types";
+export type { MirrorSyncExecutionInput } from "#/mirror/sync-types";
+/**
+ * Runs the mirror sync across the targeted packages and returns the aggregate stats.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function runMirrorSync(fs: FilesystemPort, input: MirrorSyncExecutionInput): Promise<Result<GlobalStats, AppError>>;

package/dist/mirror/sync.js

@@ -83,9 +83,11 @@ function mirrorTargetsFromWorkspaceLayout(rootDir, layoutOutcome) {
         return { relPaths: [], multiSource: "declared-empty" };
     }
     const multiSource = layoutOutcome.layoutSource;
-    const relPaths = layoutOutcome.packageDirectoryPathsAbsolute
-        .map((absolutePath) => normalizePath(path.relative(rootDir, absolutePath)))
-        .filter((relativePath) => relativePath.length > 0);
+    // A single-package root maps to "." (path.relative to itself is empty); a workspace maps to subpaths.
+    const relPaths = layoutOutcome.packageDirectoryPathsAbsolute.map((absolutePath) => {
+        const relativePath = normalizePath(path.relative(rootDir, absolutePath));
+        return relativePath.length > 0 ? relativePath : ".";
+    });
     relPaths.sort((left, right) => left.localeCompare(right));
     return { relPaths, multiSource };
 }

package/dist/mirror/write-exports.d.ts

@@ -0,0 +1,15 @@
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { ExportMapData, ExportOriginalPathBySpecifier } from "#/mirror/domain/types";
+/**
+ * Writes `exports` into `package.json` via a temp file + rename (atomic on same volume).
+ * Preserves a trailing newline after JSON.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function writePackageJsonExportsAtomic(fs: FilesystemPort, packageJsonPath: string, mergeInput: {
+    generatedExports: ExportMapData;
+    managedExportSpecifiers: Array<string>;
+    originalPathBySpecifier: ExportOriginalPathBySpecifier;
+}, write?: boolean): Promise<{
+    prunedKeys: Array<string>;
+}>;

package/dist/pack-slim/cli-result.d.ts

@@ -0,0 +1,13 @@
+import type { PackSlimRunStats } from "#/pack-slim/domain/types";
+/**
+ * Maps a pack-slim run's stats to the process exit code.
+ *
+ * @since 0.8.1
+ */
+export declare function exitCodeForPackSlimResult(stats: PackSlimRunStats): number;
+/**
+ * Serializes a pack-slim run's stats as the single-line JSON summary printed under `--json`.
+ *
+ * @since 0.8.1
+ */
+export declare function formatPackSlimJsonOutput(stats: PackSlimRunStats, elapsedSeconds: number, write?: boolean): string;

package/dist/pack-slim/cli-schema.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+/**
+ * The validated serializable inputs of a pack-slim run.
+ *
+ * @since 0.8.1
+ */
+export interface PackSlimRunRequest {
+    rootDir: string;
+    packageFilter?: string | undefined;
+    write?: boolean | undefined;
+}
+/**
+ * Zod schema validating the serializable inputs of a pack-slim run.
+ *
+ * @since 0.8.1
+ */
+export declare const packSlimRunRequestSchema: z.ZodType<PackSlimRunRequest>;

package/dist/pack-slim/command.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+/**
+ * Creates the `pack-slim` subcommand, which slims published packages down to what a consumer reads before publish.
+ *
+ * @since 0.8.1
+ */
+export declare function createPackSlimCommand(): Command;

package/dist/pack-slim/command.js

@@ -8,20 +8,21 @@ import { nodeFilesystem } from "#/core/filesystem/node";
 import { logger } from "#/core/logger";
 import { err } from "#/core/result";
 import { parseWithSchema } from "#/core/schema-parse";
-import { findRepoRoot } from "#/core/workspace/resolver";
+import { resolveProjectRoot } from "#/core/workspace/resolver";
 import { exitCodeForPackSlimResult, formatPackSlimJsonOutput } from "#/pack-slim/cli-result";
 import { packSlimRunRequestSchema } from "#/pack-slim/cli-schema";
 import { PackSlimProgressPresenter } from "#/pack-slim/output";
 import { runPackSlim } from "#/pack-slim/sync";
 import { ensureWorkingTreeClean } from "#/pack-slim/working-tree";
 /**
- * Creates the `pack-slim` subcommand, which strips the source lane from published packages before publish.
+ * Creates the `pack-slim` subcommand, which slims published packages down to what a consumer reads before publish.
  *
  * @since 0.8.1
  */
 export function createPackSlimCommand() {
     const cmd = new Command("pack-slim")
-        .description("Strip src, source conditions, and dist source maps from published packages before publish")
+        .description("Strip src, source conditions, unshipped imports, dev-only scripts, devDependencies, and dist source maps from " +
+        "published packages before publish")
         .argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)")
         .option("--dry-run", "Report what would change without touching any file", false)
         .option("--force", "Run even if the git working tree has uncommitted tracked changes", false)
@@ -35,7 +36,7 @@ export function createPackSlimCommand() {
         }
         let rootDir;
         try {
-            rootDir = findRepoRoot(process.cwd(), nodeFilesystem);
+            rootDir = resolveProjectRoot(process.cwd(), nodeFilesystem).rootDir;
         }
         catch (caughtError) {
             consumeCliAppError(err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError)));

package/dist/pack-slim/domain/transform.d.ts

@@ -0,0 +1,69 @@
+/** Pure transforms that slim a package's manifest and dist for publish. */
+/**
+ * What slimming one manifest removed.
+ */
+interface ManifestSlimReport {
+    readonly filesSrcRemoved: boolean;
+    readonly exportsSourceRemoved: number;
+    readonly importsSourceRemoved: number;
+    readonly importsUnshippedRemoved: number;
+    readonly scriptsRemoved: number;
+    readonly devDependenciesRemoved: number;
+    readonly changed: boolean;
+}
+/**
+ * The slimmed manifest paired with the report of what it dropped.
+ *
+ * @since 0.8.1
+ */
+export interface SlimManifestResult {
+    readonly manifest: Record<string, unknown>;
+    readonly report: ManifestSlimReport;
+}
+/**
+ * The result of stripping the `sourceMappingURL` directive from an emitted file's text.
+ *
+ * @since 0.8.1
+ */
+export interface StripCommentResult {
+    readonly text: string;
+    readonly stripped: boolean;
+}
+/**
+ * Whether a dist entry is a source-map sidecar (`*.map`).
+ *
+ * @since 0.8.1
+ */
+export declare function isSourceMapFile(fileName: string): boolean;
+/**
+ * Whether a dist entry is an emitted file that may carry a `sourceMappingURL` directive.
+ *
+ * @since 0.8.1
+ */
+export declare function isMapAnnotatedFile(fileName: string): boolean;
+/**
+ * Whether a script name is an install or publish lifecycle hook, with or without its `pre`/`post` prefix.
+ *
+ * @remarks Publish hooks stay because `pnpm publish` runs them right after pack-slim; install hooks stay because a
+ * consumer's package manager runs them.
+ *
+ * @since 0.9.0
+ */
+export declare function isLifecycleScript(name: string): boolean;
+/**
+ * Produces a publish manifest carrying only what a consumer's `tsc` and Node read.
+ *
+ * @remarks Operates on a structural clone, so the caller's manifest is left intact. A consumer never enables `source`
+ * and resolves `#/` through `types`/`default` to `dist`, so dropping the source lane, the `imports` left pointing
+ * outside `files`, the scripts that are not lifecycle hooks, and `devDependencies` leaves the published surface whole.
+ *
+ * @since 0.8.1
+ */
+export declare function slimPublishManifest(manifest: Record<string, unknown>): SlimManifestResult;
+/**
+ * Strips every `sourceMappingURL` directive line from an emitted file's text.
+ *
+ * @since 0.8.1
+ */
+export declare function stripSourceMappingComment(text: string): StripCommentResult;
+export {};