@codefast/cli 0.11.0 → 0.13.0

package/dist/audit/imports/domain/import-policy.js

@@ -1,4 +1,6 @@
 import { parseSync } from "oxc-parser";
+import { isOxcNode, programStatements } from "#core/oxc-node";
+import { firstLineOf, lineOfOffset } from "#core/source-position";
 /**
  * The import policies enforced across the monorepo: React members by name (never a namespace,
  * default, or implicit `React.*` UMD global), and Zod as a namespace repo-wide — the house form,
@@ -20,9 +22,6 @@ export const defaultImportPolicyRules = [
             "locale set into any bundle that reaches it)",
     },
 ];
-function isOxcNode(value) {
-    return typeof value === "object" && value !== null && typeof value.type === "string";
-}
 function isIdentifierNamed(node, name) {
     return isOxcNode(node) && node.type === "Identifier" && node.name === name;
 }
@@ -41,7 +40,7 @@ function importedName(specifier) {
  */
 export function auditImportPolicySource(filePath, sourceText, rules) {
     const { program } = parseSync(filePath, sourceText);
-    const statements = program.body;
+    const statements = programStatements(program);
     const violations = [];
     const boundUmdNames = new Set();
     for (const rule of rules) {
@@ -89,7 +88,7 @@ export function auditImportPolicySource(filePath, sourceText, rules) {
         }
     }
     for (const rule of rules) {
-        if (rule.umdGlobal !== undefined && !boundUmdNames.has(rule.umdGlobal)) {
+        if (rule.umdGlobal !== undefined && !boundUmdNames.has(rule.umdGlobal) && isOxcNode(program)) {
             collectUmdGlobalReferences(program, sourceText, rule, violations);
         }
     }
@@ -124,17 +123,4 @@ function collectUmdGlobalReferences(node, sourceText, rule, violations) {
             collectUmdGlobalReferences(value, sourceText, rule, violations);
         }
     }
-}
-function lineOfOffset(sourceText, offset) {
-    let line = 1;
-    for (let index = 0; index < offset; index++) {
-        if (sourceText.charCodeAt(index) === 10) {
-            line++;
-        }
-    }
-    return line;
-}
-function firstLineOf(text) {
-    const newlineIndex = text.indexOf("\n");
-    return newlineIndex === -1 ? text : text.slice(0, newlineIndex);
 }

package/dist/audit/imports/output.d.ts

@@ -1,4 +1,4 @@
-import type { ImportsAuditResult } from "#/audit/domain/types";
+import type { ImportsAuditResult } from "#audit/domain/types";
 /**
  * Human-readable import-policy report.
  *

package/dist/audit/imports/output.js

@@ -1,4 +1,4 @@
-import { logger } from "#/core/logger";
+import { logger } from "#core/logger";
 /**
  * Human-readable import-policy report.
  *

package/dist/audit/imports/prepare.d.ts

@@ -1,7 +1,7 @@
-import type { AuditCommandPrelude } from "#/audit/prepare";
-import type { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
+import type { AuditCommandPrelude } from "#audit/prepare";
+import type { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
 /**
  * Loads config and resolves the scan target for `audit imports`.
  *

package/dist/audit/imports/prepare.js

@@ -1,4 +1,4 @@
-import { prepareRepoRootAudit } from "#/audit/prepare";
+import { prepareRepoRootAudit } from "#audit/prepare";
 /**
  * Loads config and resolves the scan target for `audit imports`.
  *

package/dist/audit/imports/run.d.ts

@@ -1,7 +1,7 @@
-import type { ImportsAuditResult } from "#/audit/domain/types";
-import { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
+import type { ImportsAuditResult } from "#audit/domain/types";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
 /**
  * Scans a target path for import-policy violations, applying each rule only to files in its scope.
  *

package/dist/audit/imports/run.js

@@ -1,10 +1,10 @@
 import path from "node:path";
-import { defaultImportPolicyRules } from "#/audit/imports/domain/import-policy";
-import { auditImportPolicySource } from "#/audit/imports/domain/import-policy";
-import { AppError, messageFrom } from "#/core/errors";
-import { createAnyGlobMatcher } from "#/core/glob";
-import { err, ok } from "#/core/result";
-import { walkTsxFiles } from "#/core/workspace/typescript-walk";
+import { defaultImportPolicyRules } from "#audit/imports/domain/import-policy";
+import { auditImportPolicySource } from "#audit/imports/domain/import-policy";
+import { AppError, messageFrom } from "#core/errors";
+import { createAnyGlobMatcher } from "#core/glob";
+import { err, ok } from "#core/result";
+import { walkTsxFiles } from "#core/workspace/typescript-walk";
 /**
  * Scans a target path for import-policy violations, applying each rule only to files in its scope.
  *

package/dist/audit/links/cli-result.d.ts

@@ -1,4 +1,4 @@
-import type { LinkAuditResult } from "#/audit/domain/types";
+import type { LinkAuditResult } from "#audit/domain/types";
 /**
  * Exit `1` when any non-allowlisted broken link remains.
  *

package/dist/audit/links/cli-result.js

@@ -1,4 +1,4 @@
-import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#/core/exit-codes";
+import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#core/exit-codes";
 /**
  * Exit `1` when any non-allowlisted broken link remains.
  *

package/dist/audit/links/domain/markdown-links.d.ts

@@ -25,9 +25,9 @@ export type MarkdownLinkScan = {
 /**
  * The anchor ids a rendered document exposes: explicit `<a id>` targets plus every heading's slug.
  *
- * @remarks Slugging matches GitHub's — lowercase, drop everything that is not a letter, number, space
- * or hyphen, then hyphenate spaces. Duplicate headings get a `-1` suffix there; this returns the base
- * only, so a link to the second copy reads as dangling rather than being silently accepted.
+ * @remarks Slugs follow GitHub's own algorithm so a link that resolves on GitHub resolves here.
+ * Repeated slugs take a `-1`, `-2`, … suffix in heading order, exactly as GitHub disambiguates them,
+ * so a link to the second copy of a heading resolves instead of reading as dangling.
  *
  * @since 0.5.0
  */

package/dist/audit/links/domain/markdown-links.js

@@ -6,9 +6,9 @@ const EXTERNAL = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i;
 /**
  * The anchor ids a rendered document exposes: explicit `<a id>` targets plus every heading's slug.
  *
- * @remarks Slugging matches GitHub's — lowercase, drop everything that is not a letter, number, space
- * or hyphen, then hyphenate spaces. Duplicate headings get a `-1` suffix there; this returns the base
- * only, so a link to the second copy reads as dangling rather than being silently accepted.
+ * @remarks Slugs follow GitHub's own algorithm so a link that resolves on GitHub resolves here.
+ * Repeated slugs take a `-1`, `-2`, … suffix in heading order, exactly as GitHub disambiguates them,
+ * so a link to the second copy of a heading resolves instead of reading as dangling.
  *
  * @since 0.5.0
  */
@@ -17,15 +17,29 @@ export function collectMarkdownAnchors(content) {
     for (const match of content.matchAll(/<a\s+id="([^"]+)"\s*><\/a>/g)) {
         anchors.add(match[1]);
     }
+    const occurrences = new Map();
     for (const match of content.matchAll(/^#{1,6}\s+(.+?)\s*$/gm)) {
-        anchors.add(match[1]
-            .toLowerCase()
-            .replaceAll(/[^\p{L}\p{N} -]/gu, "")
-            .trim()
-            .replaceAll(/\s+/g, "-"));
+        const base = slugifyHeading(match[1]);
+        let result = base;
+        while (occurrences.has(result)) {
+            occurrences.set(base, (occurrences.get(base) ?? 0) + 1);
+            result = `${base}-${occurrences.get(base)}`;
+        }
+        occurrences.set(result, 0);
+        anchors.add(result);
     }
     return anchors;
 }
+/**
+ * A heading's GitHub slug: lowercased, stripped to letters, numbers, marks, underscore and hyphen,
+ * with each remaining space turned into a hyphen — runs are kept, not collapsed, matching GitHub.
+ */
+function slugifyHeading(heading) {
+    return heading
+        .toLowerCase()
+        .replaceAll(/[^\p{L}\p{N}\p{M} _-]/gu, "")
+        .replaceAll(" ", "-");
+}
 /**
  * Every repo-local link a document makes, with the anchors it offers.
  *

package/dist/audit/links/output.d.ts

@@ -1,4 +1,4 @@
-import type { LinkAuditResult } from "#/audit/domain/types";
+import type { LinkAuditResult } from "#audit/domain/types";
 /**
  * Human-readable link audit report.
  *

package/dist/audit/links/output.js

@@ -1,4 +1,4 @@
-import { logger } from "#/core/logger";
+import { logger } from "#core/logger";
 /**
  * Human-readable link audit report.
  *

package/dist/audit/links/prepare.d.ts

@@ -1,7 +1,7 @@
-import type { AuditCommandPrelude } from "#/audit/prepare";
-import type { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
+import type { AuditCommandPrelude } from "#audit/prepare";
+import type { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
 /**
  * Loads config and resolves the scan target for `audit links`.
  *

package/dist/audit/links/prepare.js

@@ -1,4 +1,4 @@
-import { prepareRepoRootAudit } from "#/audit/prepare";
+import { prepareRepoRootAudit } from "#audit/prepare";
 /**
  * Loads config and resolves the scan target for `audit links`.
  *

package/dist/audit/links/run.d.ts

@@ -1,7 +1,7 @@
-import type { LinkAuditResult } from "#/audit/domain/types";
-import { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
+import type { LinkAuditResult } from "#audit/domain/types";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
 /**
  * Reports markdown links that point at nothing — a missing path, or an anchor the target does not offer.
  *

package/dist/audit/links/run.js

@@ -1,8 +1,8 @@
 import path from "node:path";
-import { collectMarkdownAnchors, scanMarkdownLinks } from "#/audit/links/domain/markdown-links";
-import { AppError, messageFrom } from "#/core/errors";
-import { err, ok } from "#/core/result";
-import { walkMarkdownFiles } from "#/core/workspace/markdown-walk";
+import { collectMarkdownAnchors, scanMarkdownLinks } from "#audit/links/domain/markdown-links";
+import { AppError, messageFrom } from "#core/errors";
+import { err, ok } from "#core/result";
+import { walkMarkdownFiles } from "#core/workspace/markdown-walk";
 /**
  * Reports markdown links that point at nothing — a missing path, or an anchor the target does not offer.
  *

package/dist/audit/prepare.d.ts

@@ -1,7 +1,7 @@
-import type { CodefastConfig } from "#/core/config/schema";
-import { AppError } from "#/core/errors";
-import type { Filesystem } from "#/core/filesystem/filesystem";
-import type { Result } from "#/core/result";
+import type { CodefastConfig } from "#core/config/schema";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
 /**
  * Shared prelude for an audit: repo root and the canonicalized scan target with its allowlist.
  *

package/dist/audit/prepare.js

@@ -1,8 +1,8 @@
 import path from "node:path";
-import { loadCodefastConfig } from "#/core/config";
-import { AppError, messageFrom } from "#/core/errors";
-import { err, ok } from "#/core/result";
-import { resolveProjectRoot } from "#/core/workspace/resolver";
+import { loadCodefastConfig } from "#core/config";
+import { AppError, messageFrom } from "#core/errors";
+import { err, ok } from "#core/result";
+import { resolveProjectRoot } from "#core/workspace/resolver";
 /**
  * Resolves a path that may be absolute or relative to `rootDir`.
  *

package/dist/audit/publish/cli-result.d.ts

@@ -0,0 +1,13 @@
+import type { PublishAuditResult } from "#audit/domain/types";
+/**
+ * Exit `1` when any `#/` import, unshipped publish target, or unreachable stylesheet source remains.
+ *
+ * @since 0.12.0
+ */
+export declare function exitCodeForPublishAuditResult(result: PublishAuditResult): number;
+/**
+ * Machine-readable publish audit summary for `--json`.
+ *
+ * @since 0.12.0
+ */
+export declare function formatPublishAuditJsonOutput(result: PublishAuditResult, rootDir: string): string;

package/dist/audit/publish/cli-result.js

@@ -0,0 +1,25 @@
+import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#core/exit-codes";
+/**
+ * Exit `1` when any `#/` import, unshipped publish target, or unreachable stylesheet source remains.
+ *
+ * @since 0.12.0
+ */
+export function exitCodeForPublishAuditResult(result) {
+    return isCleanPublishAudit(result) ? CLI_EXIT_SUCCESS : CLI_EXIT_GENERAL_ERROR;
+}
+/**
+ * Machine-readable publish audit summary for `--json`.
+ *
+ * @since 0.12.0
+ */
+export function formatPublishAuditJsonOutput(result, rootDir) {
+    return JSON.stringify({
+        schemaVersion: 1,
+        ok: isCleanPublishAudit(result),
+        cwd: rootDir,
+        result,
+    });
+}
+function isCleanPublishAudit(result) {
+    return result.legacyImportCount === 0 && result.unshipped.length === 0 && result.unreachableStylesheets.length === 0;
+}

package/dist/audit/publish/cli-schema.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod";
+/**
+ * Resolved request for a single publish audit run.
+ *
+ * @since 0.12.0
+ */
+export type PublishAuditRunRequest = {
+    readonly rootDir: string;
+    readonly targetPath: string;
+    readonly allowlist?: ReadonlyArray<string> | undefined;
+    readonly json: boolean;
+};
+/**
+ * Zod schema for {@link PublishAuditRunRequest}.
+ *
+ * @since 0.12.0
+ */
+export declare const publishAuditRunRequestSchema: z.ZodType<PublishAuditRunRequest>;

package/dist/audit/publish/cli-schema.js

@@ -0,0 +1,12 @@
+import * as z from "zod";
+/**
+ * Zod schema for {@link PublishAuditRunRequest}.
+ *
+ * @since 0.12.0
+ */
+export const publishAuditRunRequestSchema = z.object({
+    rootDir: z.string().min(1),
+    targetPath: z.string().min(1),
+    allowlist: z.array(z.string()).optional(),
+    json: z.boolean(),
+});

package/dist/audit/publish/domain/legacy-subpath.d.ts

@@ -0,0 +1,8 @@
+/** Detects `#/`-prefixed internal import specifiers, which Node's ESM resolver rejects on the floor. */
+import type { LegacySubpathImport } from "#audit/domain/types";
+/**
+ * Every `#/`-prefixed import specifier in a source file, with its line number.
+ *
+ * @since 0.12.0
+ */
+export declare function scanLegacySubpathImports(content: string): Array<LegacySubpathImport>;

package/dist/audit/publish/domain/legacy-subpath.js

@@ -0,0 +1,22 @@
+/** Detects `#/`-prefixed internal import specifiers, which Node's ESM resolver rejects on the floor. */
+// A `#/` specifier in import position — after `from`, `import(`, or `require(`. Anchoring on the keyword
+// rules out an unrelated string that merely contains `#/`, such as this rule's own diagnostic text.
+const LEGACY_SUBPATH_SPECIFIER = /(?:\bfrom|\bimport|\brequire)\b\s*\(?\s*(["']#\/[^"']*["'])/g;
+/**
+ * Every `#/`-prefixed import specifier in a source file, with its line number.
+ *
+ * @since 0.12.0
+ */
+export function scanLegacySubpathImports(content) {
+    const found = [];
+    const lines = content.split("\n");
+    for (const [index, line] of lines.entries()) {
+        for (const match of line.matchAll(LEGACY_SUBPATH_SPECIFIER)) {
+            const raw = match[1];
+            if (raw !== undefined) {
+                found.push({ line: index + 1, raw });
+            }
+        }
+    }
+    return found;
+}

package/dist/audit/publish/domain/stylesheet-sources.d.ts

@@ -0,0 +1,22 @@
+/** Reads the paths a stylesheet registers with Tailwind's `@source` and checks them against a shipped file list. */
+import type { StylesheetSource } from "#audit/domain/types";
+/**
+ * Every path a stylesheet registers with `@source`, with the line it sits on.
+ *
+ * @since 0.13.0
+ */
+export declare function scanStylesheetSources(content: string): Array<StylesheetSource>;
+/**
+ * Whether a stylesheet's `@source` paths all miss the files its package ships.
+ *
+ * @remarks Paths are package-relative and POSIX. A path that leaves the package names another package's files, which
+ * this tarball cannot vouch for, so it is not judged. One reachable path is enough: a workspace-only lane beside the
+ * published one is expected.
+ *
+ * @param stylesheetPath - The stylesheet, relative to its package root.
+ * @param sources - What {@link scanStylesheetSources} found in it.
+ * @param shippedFiles - Every file the package's tarball ships, relative to the package root.
+ *
+ * @since 0.13.0
+ */
+export declare function missesShippedFiles(stylesheetPath: string, sources: ReadonlyArray<StylesheetSource>, shippedFiles: ReadonlyArray<string>): boolean;

package/dist/audit/publish/domain/stylesheet-sources.js

@@ -0,0 +1,64 @@
+/** Reads the paths a stylesheet registers with Tailwind's `@source` and checks them against a shipped file list. */
+import path from "node:path";
+import { createAnyGlobMatcher } from "#core/glob";
+import { lineOfOffset } from "#core/source-position";
+// A plain `@source "<path>";` — `@source not …` excludes paths and `@source inline(…)` names classes, so neither
+// registers files.
+const SOURCE_DIRECTIVE = /@source\s+(["'])([^"']+)\1\s*;/g;
+// A string or a comment. Strings match first, so the `/**/` of a quoted glob is never read as a comment.
+const STRING_OR_COMMENT = /("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')|\/\*[\s\S]*?\*\//g;
+const GLOB_CHARACTERS = /[*?[\]{}]/;
+/**
+ * Every path a stylesheet registers with `@source`, with the line it sits on.
+ *
+ * @since 0.13.0
+ */
+export function scanStylesheetSources(content) {
+    // Blanking comments keeps every offset in place, so a commented-out directive drops out and lines still count.
+    const code = content.replaceAll(STRING_OR_COMMENT, (match, quoted) => quoted ?? match.replaceAll(/[^\n]/g, " "));
+    const found = [];
+    for (const match of code.matchAll(SOURCE_DIRECTIVE)) {
+        const pattern = match[2];
+        if (pattern !== undefined) {
+            found.push({ line: lineOfOffset(code, match.index), pattern });
+        }
+    }
+    return found;
+}
+/**
+ * Whether a stylesheet's `@source` paths all miss the files its package ships.
+ *
+ * @remarks Paths are package-relative and POSIX. A path that leaves the package names another package's files, which
+ * this tarball cannot vouch for, so it is not judged. One reachable path is enough: a workspace-only lane beside the
+ * published one is expected.
+ *
+ * @param stylesheetPath - The stylesheet, relative to its package root.
+ * @param sources - What {@link scanStylesheetSources} found in it.
+ * @param shippedFiles - Every file the package's tarball ships, relative to the package root.
+ *
+ * @since 0.13.0
+ */
+export function missesShippedFiles(stylesheetPath, sources, shippedFiles) {
+    const patterns = sources.flatMap((source) => packagePatternsFor(stylesheetPath, source.pattern));
+    if (patterns.length === 0) {
+        return false;
+    }
+    const isReached = createAnyGlobMatcher(patterns, { dot: true });
+    return !shippedFiles.some(isReached);
+}
+// Tailwind resolves a `@source` path against the stylesheet's directory; a path without a glob is a file or a
+// directory, and a directory registers everything beneath it.
+function packagePatternsFor(stylesheetPath, pattern) {
+    if (path.posix.isAbsolute(pattern)) {
+        return [];
+    }
+    const resolved = path.posix.normalize(path.posix.join(path.posix.dirname(stylesheetPath), pattern));
+    if (resolved === ".." || resolved.startsWith("../")) {
+        return [];
+    }
+    if (GLOB_CHARACTERS.test(resolved)) {
+        return [resolved];
+    }
+    const withoutTrailingSlash = resolved.replace(/\/+$/, "");
+    return withoutTrailingSlash === "." ? ["**"] : [withoutTrailingSlash, `${withoutTrailingSlash}/**`];
+}

package/dist/audit/publish/output.d.ts

@@ -0,0 +1,7 @@
+import type { PublishAuditResult } from "#audit/domain/types";
+/**
+ * Human-readable publish audit report.
+ *
+ * @since 0.12.0
+ */
+export declare function presentPublishAuditResult(result: PublishAuditResult): void;

package/dist/audit/publish/output.js

@@ -0,0 +1,33 @@
+import { logger } from "#core/logger";
+/**
+ * Human-readable publish audit report.
+ *
+ * @since 0.12.0
+ */
+export function presentPublishAuditResult(result) {
+    for (const file of result.legacyImportFiles) {
+        logger.out(`\n${file.relativePath}`);
+        for (const { line, raw } of file.imports) {
+            logger.out(`  ${line}: ${raw} → use a bare "#" prefix, not "#/"`);
+        }
+    }
+    for (const { packageName, field, subpath, target } of result.unshipped) {
+        logger.out(`\n${packageName}: ${field}["${subpath}"] → ${target} is not shipped by "files"`);
+    }
+    for (const { packageName, stylesheet, sources, missingFilesEntries } of result.unreachableStylesheets) {
+        logger.out(`\n${packageName}: ${stylesheet} registers no file the tarball ships`);
+        for (const { line, pattern } of sources) {
+            logger.out(`  ${line}: @source "${pattern}"`);
+        }
+        if (missingFilesEntries.length > 0) {
+            logger.out(`  not on disk: ${missingFilesEntries.join(", ")} — build the package first`);
+        }
+    }
+    const problems = result.legacyImportCount + result.unshipped.length + result.unreachableStylesheets.length;
+    if (problems > 0) {
+        logger.out(`\n✖ ${result.legacyImportCount} legacy "#/" import(s), ${result.unshipped.length} unshipped target(s), ${result.unreachableStylesheets.length} stylesheet(s) registering nothing shipped`);
+    }
+    else {
+        logger.out(`✓ No "#/" imports across ${result.scannedFileCount} file(s); every publish target and stylesheet source ships across ${result.packageCount} package(s)`);
+    }
+}

package/dist/audit/publish/prepare.d.ts

@@ -0,0 +1,16 @@
+import type { AuditCommandPrelude } from "#audit/prepare";
+import type { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+/**
+ * Loads config and resolves the scan target for `audit publish`.
+ *
+ * @remarks Defaults to the repo root: the audit walks every published package's source and manifest, so
+ * a single-package target would miss the cross-package surface. It takes no allowlist.
+ *
+ * @since 0.12.0
+ */
+export declare function preparePublishAudit(fs: Filesystem, args: {
+    readonly currentWorkingDirectory: string;
+    readonly rawTarget: string | undefined;
+}): Promise<Result<AuditCommandPrelude, AppError>>;

package/dist/audit/publish/prepare.js

@@ -0,0 +1,12 @@
+import { prepareRepoRootAudit } from "#audit/prepare";
+/**
+ * Loads config and resolves the scan target for `audit publish`.
+ *
+ * @remarks Defaults to the repo root: the audit walks every published package's source and manifest, so
+ * a single-package target would miss the cross-package surface. It takes no allowlist.
+ *
+ * @since 0.12.0
+ */
+export async function preparePublishAudit(fs, args) {
+    return prepareRepoRootAudit(fs, args, () => []);
+}

package/dist/audit/publish/run.d.ts

@@ -0,0 +1,15 @@
+import type { PublishAuditResult } from "#audit/domain/types";
+import { AppError } from "#core/errors";
+import type { Filesystem } from "#core/filesystem/filesystem";
+import type { Result } from "#core/result";
+/**
+ * Reports what would break a consumer's install: a `#/`-prefixed import Node's ESM resolver rejects on
+ * the floor, an `exports`/`imports` target the slimmed publish manifest does not ship, and a shipped
+ * stylesheet whose `@source` paths reach none of the files that do ship.
+ *
+ * @since 0.12.0
+ */
+export declare function runPublishAudit(fs: Filesystem, args: {
+    readonly rootDir: string;
+    readonly targetPath: string;
+}): Promise<Result<PublishAuditResult, AppError>>;