@dep-radius/core 0.1.0

package/dist/inventory/manifests.d.ts

@@ -0,0 +1,9 @@
+import type { Manifest } from "../model.ts";
+export declare const SKIP_DIRS: Set<string>;
+export declare function gitFiles(root: string): Promise<string[] | undefined>;
+export declare function walkFiles(root: string, accept: (rel: string) => boolean, limit?: number): Promise<string[]>;
+export declare function listProjectFiles(root: string): Promise<string[]>;
+export declare function findManifests(root: string, files: string[]): Promise<Manifest[]>;
+export declare function toManifest(abs: string, json: Record<string, unknown>): Manifest;
+export declare function relPath(root: string, abs: string): string;
+//# sourceMappingURL=manifests.d.ts.map

package/dist/inventory/manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifests.d.ts","sourceRoot":"","sources":["../../src/inventory/manifests.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAyB,QAAQ,EAAE,MAAM,aAAa,CAAA;AAKlE,eAAO,MAAM,SAAS,aAkBpB,CAAA;AASF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAc1E;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,EAChC,KAAK,SAAU,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOtE;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,QAAQ,EAAE,CAAC,CAgBrB;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,QAAQ,CAsCV;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/inventory/manifests.js

@@ -0,0 +1,135 @@
+import { promisify } from "node:util";
+import { execFile } from "node:child_process";
+import { readdir, readFile } from "node:fs/promises";
+import { dirname, join, relative, sep } from "node:path";
+import { classifySpec } from "./specifiers.js";
+const run = promisify(execFile);
+// Folders that hold output or third party code, never a manifest someone wrote.
+export const SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".next",
+    ".nuxt",
+    ".output",
+    ".svelte-kit",
+    ".turbo",
+    ".vercel",
+    ".cache",
+    ".parcel-cache",
+    ".yarn",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    "bower_components",
+    "jspm_packages",
+]);
+const FIELDS = [
+    "dependencies",
+    "devDependencies",
+    "optionalDependencies",
+    "peerDependencies",
+];
+export async function gitFiles(root) {
+    try {
+        const { stdout } = await run("git", ["ls-files", "-co", "--exclude-standard", "-z"], {
+            cwd: root,
+            maxBuffer: 256 * 1024 * 1024,
+        });
+        return stdout.split("\0").filter(Boolean);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function walkFiles(root, accept, limit = 200_000) {
+    const out = [];
+    const stack = [""];
+    while (stack.length > 0 && out.length < limit) {
+        const rel = stack.pop();
+        let entries;
+        try {
+            entries = await readdir(join(root, rel), { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const childRel = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory()) {
+                if (!SKIP_DIRS.has(e.name))
+                    stack.push(childRel);
+            }
+            else if (e.isFile() && accept(childRel)) {
+                out.push(childRel);
+            }
+        }
+    }
+    return out.sort();
+}
+export async function listProjectFiles(root) {
+    const git = await gitFiles(root);
+    if (git)
+        return git
+            .filter((f) => !f.split("/").some((seg) => seg === "node_modules"))
+            .sort();
+    return walkFiles(root, () => true);
+}
+export async function findManifests(root, files) {
+    const paths = files.filter((f) => f === "package.json" || f.endsWith("/package.json"));
+    const manifests = [];
+    for (const rel of paths) {
+        const abs = join(root, rel);
+        let json;
+        try {
+            json = JSON.parse(await readFile(abs, "utf8"));
+        }
+        catch {
+            continue;
+        }
+        manifests.push(toManifest(abs, json));
+    }
+    return manifests;
+}
+export function toManifest(abs, json) {
+    const deps = [];
+    for (const field of FIELDS) {
+        const block = json[field];
+        if (!block || typeof block !== "object")
+            continue;
+        for (const [key, spec] of Object.entries(block)) {
+            if (typeof spec !== "string")
+                continue;
+            const c = classifySpec(spec);
+            deps.push({
+                key,
+                spec,
+                field,
+                specKind: c.kind,
+                ...(c.aliasOf ? { aliasOf: c.aliasOf } : {}),
+            });
+        }
+    }
+    return {
+        path: abs,
+        dir: dirname(abs),
+        name: typeof json.name === "string" ? json.name : undefined,
+        private: json.private === true,
+        deps,
+        scripts: (json.scripts && typeof json.scripts === "object"
+            ? json.scripts
+            : {}),
+        exports: json.exports,
+        main: typeof json.main === "string" ? json.main : undefined,
+        module: typeof json.module === "string" ? json.module : undefined,
+        types: typeof json.types === "string"
+            ? json.types
+            : typeof json.typings === "string"
+                ? json.typings
+                : undefined,
+    };
+}
+export function relPath(root, abs) {
+    const r = relative(root, abs);
+    return (r || ".").split(sep).join("/");
+}

package/dist/inventory/specifiers.d.ts

@@ -0,0 +1,8 @@
+import type { SpecKind } from "../model.ts";
+export declare function classifySpec(spec: string): {
+    kind: SpecKind;
+    aliasOf?: string;
+};
+export declare function packageNameOf(specifier: string): string | undefined;
+export declare function subpathOf(specifier: string, pkg: string): string;
+//# sourceMappingURL=specifiers.d.ts.map

package/dist/inventory/specifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specifiers.d.ts","sourceRoot":"","sources":["../../src/inventory/specifiers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAC1C,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CA6BA;AAGD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAenE;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/inventory/specifiers.js

@@ -0,0 +1,53 @@
+import semver from "semver";
+export function classifySpec(spec) {
+    const s = spec.trim();
+    if (s.startsWith("workspace:"))
+        return { kind: "workspace" };
+    if (s.startsWith("catalog:"))
+        return { kind: "catalog" };
+    if (s.startsWith("link:"))
+        return { kind: "link" };
+    if (s.startsWith("file:") ||
+        s.startsWith("./") ||
+        s.startsWith("../") ||
+        s.startsWith("/") ||
+        s.startsWith("~/"))
+        return { kind: "file" };
+    if (s.startsWith("npm:")) {
+        const rest = s.slice(4);
+        const at = rest.lastIndexOf("@");
+        return { kind: "alias", aliasOf: at > 0 ? rest.slice(0, at) : rest };
+    }
+    if (/^(git\+|git:|github:|gitlab:|bitbucket:)/.test(s) ||
+        /^[\w-]+\/[\w.-]+(#.*)?$/.test(s))
+        return { kind: "git" };
+    if (/^https?:/.test(s))
+        return { kind: "url" };
+    if (s === "" || s === "*" || s === "latest" || semver.validRange(s)) {
+        return { kind: s === "latest" ? "tag" : "range" };
+    }
+    if (/^[a-z][\w.-]*$/i.test(s))
+        return { kind: "tag" };
+    return { kind: "range" };
+}
+// "lib/locales" -> lib ; "@scope/name/sub" -> @scope/name ; relative or node: -> undefined
+export function packageNameOf(specifier) {
+    if (!specifier ||
+        specifier.startsWith(".") ||
+        specifier.startsWith("/") ||
+        specifier.startsWith("#"))
+        return undefined;
+    if (/^[a-z]+:/i.test(specifier))
+        return undefined;
+    const parts = specifier.split("/");
+    if (specifier.startsWith("@")) {
+        if (parts.length < 2 || !parts[1])
+            return undefined;
+        return `${parts[0]}/${parts[1]}`;
+    }
+    return parts[0];
+}
+export function subpathOf(specifier, pkg) {
+    const rest = specifier.slice(pkg.length);
+    return rest ? `.${rest}` : ".";
+}

package/dist/labels.d.ts

@@ -0,0 +1,2 @@
+export declare const UNSEEN_LABEL: Record<string, string>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgB/C,CAAA"}

package/dist/labels.js

@@ -0,0 +1,18 @@
+// Plain words for the kinds of things radius cannot see, shared by the verdict and the renderers.
+export const UNSEEN_LABEL = {
+    "side-effect-import": "imported for side effects",
+    "config-reference": "named in a config file",
+    "script-bin": "run from scripts",
+    "css-import": "imported from CSS",
+    "convention-framework": "a framework used through file conventions",
+    "ambient-types": "ambient types",
+    "namespace-escape": "passed around as a whole",
+    "computed-member": "read with computed keys",
+    "dynamic-import-escape": "loaded with import() and passed on",
+    "prefix-dynamic-import": "loaded by a computed subpath",
+    "public-reexport": "re-exported to your own consumers",
+    "unresolved-local-import": "reached through imports that did not resolve",
+    "derived-escape": "values passed through too many files",
+    "unparseable-file": "used in files that did not parse",
+    "unresolved-against-surface": "names not found in its types",
+};

package/dist/model.d.ts

@@ -0,0 +1,276 @@
+export type VersionSource = "node_modules" | "lockfile:npm" | "lockfile:pnpm" | "lockfile:yarn" | "lockfile:bun" | "manifest-range";
+export type DepField = "dependencies" | "devDependencies" | "optionalDependencies" | "peerDependencies";
+export type SpecKind = "range" | "tag" | "alias" | "workspace" | "catalog" | "link" | "file" | "git" | "url";
+export interface DeclaredDep {
+    key: string;
+    spec: string;
+    field: DepField;
+    specKind: SpecKind;
+    aliasOf?: string;
+}
+export interface Manifest {
+    path: string;
+    dir: string;
+    name?: string;
+    private: boolean;
+    deps: DeclaredDep[];
+    scripts: Record<string, string>;
+    exports?: unknown;
+    main?: string;
+    module?: string;
+    types?: string;
+}
+export type InstalledFlag = "alias" | "patched" | "not-in-registry" | "prerelease-installed" | "range-guess";
+export interface InstalledDep {
+    id: string;
+    name: string;
+    version: string;
+    versionSource: VersionSource;
+    dir?: string;
+    local: boolean;
+    declaredBy: {
+        manifest: string;
+        key: string;
+        field: DepField;
+    }[];
+    flags: InstalledFlag[];
+}
+export interface NotAnalyzed {
+    pkg: string;
+    reason: string;
+}
+export interface Inventory {
+    root: string;
+    manifests: Manifest[];
+    installed: InstalledDep[];
+    local: string[];
+    notAnalyzed: NotAnalyzed[];
+}
+export type Bump = "major" | "minor" | "patch";
+export interface Candidate {
+    pkg: string;
+    from: string;
+    to: string;
+    bump: Bump;
+    publishedAt: string;
+    range: string[];
+    skippedNewer: {
+        version: string;
+        reason: "too-new" | "deprecated" | "above-dist-tag";
+        publishedAt?: string;
+    }[];
+    alsoAvailable?: {
+        version: string;
+        bump: Bump;
+    };
+}
+export interface ChainSeg {
+    name: string;
+    call: boolean;
+    construct?: boolean;
+}
+export interface Site {
+    file: string;
+    line: number;
+    col: number;
+    typeOnly: boolean;
+    text: string;
+    via?: string[];
+}
+export type Binding = {
+    kind: "named";
+    imported: string;
+} | {
+    kind: "namespace";
+} | {
+    kind: "default";
+} | {
+    kind: "cjs";
+} | {
+    kind: "derived";
+};
+export interface RefOrigin {
+    binding: Exclude<Binding, {
+        kind: "derived";
+    }>;
+    entry: string;
+    chain: ChainSeg[];
+    callSelf: boolean;
+}
+export interface RawRef {
+    installedId: string;
+    pkg: string;
+    specifier: string;
+    entry: string;
+    binding: Binding;
+    chain: ChainSeg[];
+    callSelf: boolean;
+    site: Site;
+    origin?: RefOrigin;
+}
+export type OpaqueKind = "side-effect-import" | "config-reference" | "script-bin" | "css-import" | "convention-framework" | "ambient-types";
+export type BlindSpotKind = "namespace-escape" | "computed-member" | "dynamic-import-escape" | "prefix-dynamic-import" | "public-reexport" | "unresolved-local-import" | "derived-escape" | "unparseable-file" | "unresolved-against-surface";
+export type GlobalBlindSpotKind = "dynamic-import-nonliteral" | "require-nonliteral" | "skipped-generated" | "unparseable-file";
+export interface Counted<K extends string> {
+    kind: K;
+    count: number;
+    examples: Site[];
+}
+export interface PackageUsage {
+    installedId: string;
+    pkg: string;
+    refs: RawRef[];
+    strongNames: string[];
+    weakNames: string[];
+    files: number;
+    opaque: Counted<OpaqueKind>[];
+    blindSpots: Counted<BlindSpotKind>[];
+}
+export interface UsageMap {
+    scannedFiles: number;
+    packages: Record<string, PackageUsage>;
+    global: Counted<GlobalBlindSpotKind>[];
+}
+export type CanonPath = string;
+export type SymbolKind = "function" | "class" | "interface" | "type" | "variable" | "enum" | "enum-member" | "namespace" | "member" | "static-member";
+export interface SurfaceSymbol {
+    path: CanonPath;
+    kind: SymbolKind;
+    sig: string[];
+    deprecated: boolean;
+    returns?: CanonPath;
+    instanceOf?: CanonPath;
+    aliasOf?: CanonPath;
+}
+export type SurfaceFlag = "wildcard-truncated" | "symbol-cap" | "external-types-unresolved";
+export interface Surface {
+    pkg: string;
+    version: string;
+    integrity: string;
+    ts: string;
+    algo: number;
+    typesFrom: "package" | "@types";
+    entries: Record<string, {
+        typesFile: string;
+        exportEquals: boolean;
+        externalReexports?: string[];
+    }>;
+    symbols: Record<CanonPath, SurfaceSymbol>;
+    flags: SurfaceFlag[];
+}
+export interface SurfaceChange {
+    path: CanonPath;
+    kind: SymbolKind;
+    before?: string[];
+    after?: string[];
+    alsoAt: CanonPath[];
+}
+export interface SurfaceDelta {
+    removed: SurfaceChange[];
+    changed: SurfaceChange[];
+    deprecated: SurfaceChange[];
+    widened: SurfaceChange[];
+    added: SurfaceChange[];
+}
+export type NoteSourceKind = "tarball-changelog" | "github-release" | "repo-changelog";
+export interface VersionNotes {
+    version: string;
+    status: "found" | "not-published" | "unavailable";
+    source?: {
+        kind: NoteSourceKind;
+        url: string;
+    };
+    reason?: "offline" | "rate-limited" | "no-repo" | "unsupported-host" | "http-error" | "stub-body";
+}
+export type RegionKind = "title" | "prose" | "inline-code" | "code-block";
+export interface NoteEntry {
+    id: string;
+    version: string;
+    title: string;
+    headingPath: string[];
+    regions: {
+        kind: RegionKind;
+        text: string;
+    }[];
+    breakingMarker: boolean;
+    noise: boolean;
+    refs: string[];
+}
+export interface NoteHit {
+    name: string;
+    strength: "strong" | "weak";
+    region: RegionKind;
+}
+export interface NoteMatch {
+    entry: NoteEntry;
+    hits: NoteHit[];
+    direct: boolean;
+}
+export type NotesCoverage = "complete" | "partial" | "none-published" | "unavailable" | "disabled";
+export type Verdict = "quiet" | "review" | "blocked";
+export type ReasonCode = "removed-touched" | "changed-touched" | "deprecated-touched" | "possibly-touched" | "notes-match" | "unattributed-breaking" | "blind-spots" | "opaque-usage" | "not-referenced" | "flagged-install" | "surface-incomplete" | "no-evidence" | "major-unproven" | "notes-complete-no-match" | "surface-clean" | "caveat-no-types" | "caveat-no-notes";
+export interface VerdictReason {
+    code: ReasonCode;
+    detail: string;
+}
+export interface Touched {
+    change: SurfaceChange;
+    bucket: "removed" | "changed" | "deprecated";
+    strength: "strong" | "weak";
+    sites: Site[];
+}
+export type SurfaceStatus = "computed" | "no-types" | "types-from-@types" | "types-elsewhere" | "failed" | "disabled" | "offline-uncached";
+export interface PackageBrief {
+    pkg: string;
+    from: string;
+    to: string;
+    bump: Bump;
+    publishedAt: string;
+    versionSource: VersionSource;
+    manifests: string[];
+    level: 0 | 1;
+    verdict: Verdict;
+    reasons: VerdictReason[];
+    surface: {
+        status: SurfaceStatus;
+        detail?: string;
+        changes?: number;
+        added?: number;
+        touched: Touched[];
+    };
+    notes: {
+        coverage: NotesCoverage;
+        perVersion: VersionNotes[];
+        total: number;
+        matched: NoteMatch[];
+        unattributedBreaking: NoteEntry[];
+    };
+    usage: {
+        files: number;
+        sites: Site[];
+        byName: Record<string, Site[]>;
+        strongNames: string[];
+        weakNames: string[];
+        opaque: Counted<OpaqueKind>[];
+        blindSpots: Counted<BlindSpotKind>[];
+    };
+    skippedNewer: Candidate["skippedNewer"];
+    alsoAvailable?: Candidate["alsoAvailable"];
+}
+export interface Brief {
+    schemaVersion: 1;
+    tool: {
+        version: string;
+        typescript: string;
+    };
+    root: string;
+    generatedAt: string;
+    manifests: number;
+    packages: PackageBrief[];
+    upToDate: number;
+    notAnalyzed: NotAnalyzed[];
+    global: Counted<GlobalBlindSpotKind>[];
+    limits: string[];
+    exitCode: 0 | 1 | 2;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/model.js

@@ -0,0 +1,2 @@
+// The one set of types every stage reads and writes. Renderers only ever see a Brief.
+export {};

package/dist/notes/changelog.d.ts

@@ -0,0 +1,11 @@
+interface Heading {
+    line: number;
+    level: number;
+    text: string;
+    span: number;
+}
+export declare function headingsOf(lines: string[]): Heading[];
+export declare function versionOfHeading(text: string): string | undefined;
+export declare function changelogSections(text: string): Map<string, string>;
+export {};
+//# sourceMappingURL=changelog.d.ts.map

package/dist/notes/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/notes/changelog.ts"],"names":[],"mappings":"AAOA,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IAEZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CA6BrD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBnE"}

package/dist/notes/changelog.js

@@ -0,0 +1,60 @@
+// Splits a changelog file into one body per version. Headings come as ATX (`## 1.2.3`) or setext
+// (`1.2.3 / 2024-11-06` underlined with `===`), and the version sits anywhere in them:
+// `[1.2.3]`, `v1.2.3`, `pkg@1.2.3`, `1.2.3 (2024-01-01)`.
+const VERSION_IN_HEADING = /(?<![\d.])v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(?![\d.])/;
+export function headingsOf(lines) {
+    const out = [];
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const atx = /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
+        if (atx?.[1] && atx[2]) {
+            out.push({ line: i, level: atx[1].length, text: atx[2], span: 1 });
+            continue;
+        }
+        const next = lines[i + 1];
+        if (next !== undefined &&
+            line.trim() &&
+            !/^\s*([-*+]|\d+\.)\s/.test(line) &&
+            !/^\s{4}/.test(line)) {
+            if (/^=+\s*$/.test(next))
+                out.push({ line: i, level: 1, text: line.trim(), span: 2 });
+            else if (/^-{2,}\s*$/.test(next))
+                out.push({ line: i, level: 2, text: line.trim(), span: 2 });
+        }
+    }
+    return out;
+}
+export function versionOfHeading(text) {
+    return VERSION_IN_HEADING.exec(text)?.[1];
+}
+export function changelogSections(text) {
+    const lines = text.split(/\r?\n/);
+    const headings = headingsOf(lines);
+    const sections = new Map();
+    for (let h = 0; h < headings.length; h++) {
+        const head = headings[h];
+        const version = versionOfHeading(head.text);
+        if (!version || sections.has(version))
+            continue;
+        let end = lines.length;
+        for (let k = h + 1; k < headings.length; k++) {
+            const other = headings[k];
+            if (other.level <= head.level || versionOfHeading(other.text)) {
+                end = other.line;
+                break;
+            }
+        }
+        sections.set(version, lines
+            .slice(head.line + head.span, end)
+            .join("\n")
+            .trim());
+    }
+    return sections;
+}

package/dist/notes/collect.d.ts

@@ -0,0 +1,13 @@
+import type { Ctx } from "../options.ts";
+import type { Packument } from "../registry/packument.ts";
+import type { RegistryConfig } from "../registry/npmrc.ts";
+import type { Candidate, NoteEntry, NotesCoverage, VersionNotes } from "../model.ts";
+export interface CollectedNotes {
+    perVersion: VersionNotes[];
+    entries: NoteEntry[];
+    coverage: NotesCoverage;
+}
+export declare function collectNotes(ctx: Ctx, cfg: RegistryConfig, p: Packument, c: Candidate): Promise<CollectedNotes>;
+export declare function isPointerOnly(body: string): boolean;
+export declare function prereleasesIn(p: Packument, stable: string[]): string[];
+//# sourceMappingURL=collect.d.ts.map

package/dist/notes/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/notes/collect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAIxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,aAAa,EAEb,YAAY,EACb,MAAM,aAAa,CAAA;AAUpB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,QAAQ,EAAE,aAAa,CAAA;CACxB;AAID,wBAAsB,YAAY,CAChC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,cAAc,EACnB,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,GACX,OAAO,CAAC,cAAc,CAAC,CA4LzB;AAKD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBnD;AAMD,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAYtE"}