@absolutejs/changelog 0.1.2 → 0.3.0

package/dist/entries.d.ts

@@ -8,10 +8,18 @@ export type LoadedEntries = {
     entries: LoadedEntry[];
     problems: string[];
 };
-/** Every declaration file a build produced, so a release can be checked
- *  against the types it is about to publish rather than against the ones it
- *  published last time. */
-export declare const builtSurface: (packageRoot: string, out?: string) => Promise<import("./surface").PackageSurface | undefined>;
+/**
+ * The public surface a build produced, read the way a consumer would.
+ *
+ * From the entry points the manifest declares, following the export graph --
+ * not by heaping every declaration file together, which counts names no
+ * consumer can import and cannot see one being withdrawn.
+ *
+ * Nothing when the manifest's entry points are not on disk: that is a package
+ * about to publish types it has not built, and passing it would be the gate
+ * going quiet at the worst possible moment.
+ */
+export declare const builtSurface: (packageRoot: string) => Promise<import("./surface").PackageSurface | undefined>;
 export declare const changelogPaths: (packageRoot: string) => {
     history: string;
     json: string;
@@ -19,5 +27,16 @@ export declare const changelogPaths: (packageRoot: string) => {
     unreleased: string;
 };
 /** Every pending entry, in a stable order so a release reads the same twice. */
-export declare const loadUnreleased: (packageRoot: string) => Promise<LoadedEntries>;
+export declare const loadUnreleased: (packageRoot: string) => Promise<{
+    entries: LoadedEntry[];
+    problems: string[];
+}>;
 export declare const readJsonFile: (path: string) => Promise<unknown>;
+/**
+ * Anything in the entry directory that is not an entry.
+ *
+ * A `.md` note dropped in here, or a `.txt` somebody meant as a placeholder,
+ * is read by nothing and consumed by nothing -- it sits there through every
+ * release looking like a change that was recorded.
+ */
+export declare const strayEntries: (packageRoot: string) => Promise<string[]>;

package/dist/index.d.ts

@@ -3,8 +3,8 @@ export { change, manual, moved, renamed } from "./authoring";
 export { builtSurface, changelogPaths, loadUnreleased, readJsonFile, type LoadedEntries, type LoadedEntry, } from "./entries";
 export { changesBetween, disruptiveBetween, mechanicalMigrations, migrationsBetween, parseChangelog, releasesBetween, symbolsDisturbedBetween, validateChange, type ChangeAt, type ChangelogRead, type MigrationAt, } from "./read";
 export { describeReconciliation, reconcile, type Reconciliation, type Unannounced, } from "./reconcile";
-export { packageArchive, packageVersions, publishedChangelog, publishedSurface, type PackageVersions, type RegistryOptions, } from "./registry";
-export { changeShape, diffSurface, exportedDeclarations, notable, surfaceOfArchive, surfaceOfFiles, type ChangeShape, type PackageSurface, type SurfaceChange, type SurfaceDiff, } from "./surface";
+export { isPackageName, packageArchive, packageVersions, publishedChangelog, publishedSurface, type PackageVersions, type RegistryOptions, } from "./registry";
+export { changeShape, declaresTypes, diffSurface, notable, surfaceOfArchive, surfaceOfFiles, typeEntriesOf, type ChangeShape, type PackageSurface, type SurfaceChange, type SurfaceDiff, } from "./surface";
 export { asText, readTar, type TarLimits } from "./tarball";
 export { CHANGELOG_CONTRACT, CHANGELOG_FILE, CHANGELOG_MARKDOWN, CHANGE_KINDS, DISRUPTIVE_KINDS, isDisruptive, isMechanical, UNRELEASED_DIRECTORY, type Change, type ChangeKind, type Changelog, type DisruptiveChange, type DisruptiveKind, type Migration, type NonEmpty, type OrdinaryChange, type Release, } from "./types";
 export { compareVersions, isPrerelease, nextVersion, parseVersion, releaseKindFor, type ReleaseKind, } from "./versioning";