@riebeckite/plugin-diagnostics 0.0.1

package/dist/src/analyze.d.ts

@@ -0,0 +1,3 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { AnalyzerContentConfig, DiagnosticsOptions } from "./types.js";
+export declare function analyzeContent(config: AnalyzerContentConfig, options?: DiagnosticsOptions): Promise<Diagnostic[]>;

package/dist/src/checks/assets.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { ScanResult } from "../vault.js";
+import { type AnalysisState, type NormalizedOptions } from "./shared.js";
+export declare function checkUnusedAssets(source: ScanResult, state: AnalysisState, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/excluded_public.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { ScanResult } from "../vault.js";
+import { type NormalizedOptions } from "./shared.js";
+export declare function checkExcludedPublic(source: ScanResult, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/frontmatter.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "@riebeckite/core";
+import { type ScannedNote, type ScanResult } from "../vault.js";
+import { type AnalysisState, type NormalizedOptions } from "./shared.js";
+export declare function checkFrontmatter(note: ScannedNote, source: ScanResult, state: AnalysisState, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/markdown_references.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "@riebeckite/core";
+import { type ScannedNote, type ScanResult } from "../vault.js";
+import { type AnalysisState, type NormalizedOptions } from "./shared.js";
+export declare function checkMarkdownReferences(note: ScannedNote, source: ScanResult, state: AnalysisState, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/note_metadata.d.ts

@@ -0,0 +1,5 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { ScanResult } from "../vault.js";
+import { type NormalizedOptions } from "./shared.js";
+export declare function checkSlugCollisions(source: ScanResult, options: NormalizedOptions, diagnostics: Diagnostic[]): void;
+export declare function checkDuplicateTitles(source: ScanResult, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/orphans.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "@riebeckite/core";
+import type { ScanResult } from "../vault.js";
+import { type AnalysisState, type NormalizedOptions } from "./shared.js";
+export declare function checkOrphans(source: ScanResult, state: AnalysisState, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/publish_boundary.d.ts

@@ -0,0 +1,11 @@
+import type { Diagnostic } from "@riebeckite/core";
+import { type ScanResult } from "../vault.js";
+import { type NormalizedOptions } from "./shared.js";
+/**
+ * Checks the publish boundary: content that is published must not reference
+ * content that is not. A published note that links to or embeds a
+ * non-published note can leak that note's title, excerpt, or rendered body
+ * into the public output (link cards, transclusion, search snippets), so it is
+ * reported here regardless of how the output is assembled.
+ */
+export declare function checkPublishBoundary(source: ScanResult, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/checks/shared.d.ts

@@ -0,0 +1,20 @@
+import type { Diagnostic, DiagnosticCode, DiagnosticSeverity } from "@riebeckite/core";
+import type { DiagnosticsOptions } from "../types.js";
+export type NoteLocation = {
+    slug?: string;
+    filePath?: string;
+};
+export type AnalysisState = {
+    referencedAssets: Set<string>;
+    incoming: Map<string, Set<string>>;
+};
+export type NormalizedOptions = {
+    reportUnusedAssets: boolean;
+    reportOrphans: boolean;
+    requiredFrontmatter: string[];
+    severity: Partial<Record<string, DiagnosticSeverity>>;
+};
+export declare function createAnalysisState(): AnalysisState;
+export declare function normalizeOptions(options: DiagnosticsOptions): NormalizedOptions;
+export declare function addIncoming(state: AnalysisState, target: string, source: string): void;
+export declare function pushDiagnostic(diagnostics: Diagnostic[], options: NormalizedOptions, location: NoteLocation, code: DiagnosticCode, message: string, target?: string, suggestion?: string, line?: number, column?: number): void;

package/dist/src/checks/wikilinks.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "@riebeckite/core";
+import { type ScannedNote, type ScanResult } from "../vault.js";
+import { type AnalysisState, type NormalizedOptions } from "./shared.js";
+export declare function checkWikilinks(note: ScannedNote, source: ScanResult, state: AnalysisState, options: NormalizedOptions, diagnostics: Diagnostic[]): void;

package/dist/src/frontmatter.d.ts

@@ -0,0 +1,7 @@
+export type ParsedFrontmatter = {
+    hasFrontmatter: boolean;
+    values: Record<string, unknown>;
+};
+export declare function parseFrontmatter(markdown: string): ParsedFrontmatter;
+export declare function hasField(values: Record<string, unknown>, field: string): boolean;
+export declare function getNoteTitle(values: Record<string, unknown>, slug: string): string;

package/dist/src/location.d.ts

@@ -0,0 +1,9 @@
+export type SourcePosition = {
+    line: number;
+    column: number;
+};
+export declare class LineMapper {
+    private starts;
+    constructor(text: string);
+    positionAt(index: number): SourcePosition;
+}

package/dist/src/markdown_links.d.ts

@@ -0,0 +1,7 @@
+export type MarkdownReference = {
+    kind: "link" | "image";
+    url: string;
+    line: number;
+    column: number;
+};
+export declare function extractMarkdownReferences(markdown: string): MarkdownReference[];

package/dist/src/report.d.ts

@@ -0,0 +1,13 @@
+import type { Diagnostic, DiagnosticCode } from "@riebeckite/core";
+import type { DiagnosticsReport, DiagnosticsSummary } from "./types.js";
+export declare class DiagnosticsFailure extends Error {
+    readonly report: DiagnosticsReport;
+    constructor(report: DiagnosticsReport);
+}
+export declare function buildReport(diagnostics: Diagnostic[]): DiagnosticsReport;
+export declare function summarize(diagnostics: Diagnostic[]): DiagnosticsSummary;
+export declare function groupByCode(diagnostics: Diagnostic[]): Map<DiagnosticCode, Diagnostic[]>;
+export declare function assertNoErrors(report: DiagnosticsReport): void;
+export declare function formatDiagnostics(input: Diagnostic[] | DiagnosticsReport, options?: {
+    color?: boolean;
+}): string;

package/dist/src/types.d.ts

@@ -0,0 +1,32 @@
+import type { ContentSource, Diagnostic, DiagnosticCode, DiagnosticSeverity } from "@riebeckite/core";
+export type DiagnosticsOptions = {
+    failOnError?: boolean;
+    reportUnusedAssets?: boolean;
+    reportOrphans?: boolean;
+    requiredFrontmatter?: string[];
+    severity?: Partial<Record<DiagnosticCode, DiagnosticSeverity>>;
+    exclude?: string[];
+    publishStrategy?: "explicit" | "selective";
+};
+export type DiagnosticsSummary = {
+    total: number;
+    error: number;
+    warning: number;
+    info: number;
+};
+export type DiagnosticsReport = {
+    diagnostics: Diagnostic[];
+    errors: Diagnostic[];
+    warnings: Diagnostic[];
+    infos: Diagnostic[];
+    hasErrors: boolean;
+    hasWarnings: boolean;
+    summary: DiagnosticsSummary;
+    byCode: Map<DiagnosticCode, Diagnostic[]>;
+};
+export type AnalyzerContentConfig = {
+    directory: string;
+    source?: ContentSource;
+    exclude: string[];
+    publishStrategy: "explicit" | "selective";
+};

package/dist/src/vault.d.ts

@@ -0,0 +1,48 @@
+import { type ParsedFrontmatter } from "./frontmatter.js";
+import type { AnalyzerContentConfig } from "./types.js";
+export type ScannedNote = {
+    relativePath: string;
+    slug: string;
+    markdown: string;
+    fm: ParsedFrontmatter;
+    headings: Set<string>;
+    blockIds: Set<string>;
+    excluded: boolean;
+    published: boolean;
+};
+export type ScannedAsset = {
+    relativePath: string;
+    extension: string;
+};
+export type ScanResult = {
+    includedNotes: ScannedNote[];
+    excludedNotes: ScannedNote[];
+    noteSlugs: Set<string>;
+    noteBySlug: Map<string, ScannedNote>;
+    assetPaths: Set<string>;
+    assets: ScannedAsset[];
+    filePaths: Set<string>;
+    targetIndex: Map<string, ResolvedTarget>;
+};
+export type TargetKind = "note" | "image" | "attachment";
+export type ResolvedTarget = {
+    kind: TargetKind;
+    value: string;
+};
+export type WikilinkMatch = {
+    embed: boolean;
+    target: string;
+    fragment: string | null;
+    index: number;
+};
+export declare function scanVault(config: AnalyzerContentConfig): Promise<ScanResult>;
+export declare function getWikilinkMatches(markdown: string): WikilinkMatch[];
+export declare function resolveWikilinkTarget(target: string, targetIndex: Map<string, ResolvedTarget>): ResolvedTarget | null;
+export declare function isImageTarget(target: string): boolean;
+export declare function isAssetTarget(target: string): boolean;
+export declare function resolveLocalReference(noteSlug: string, url: string): string | null;
+export declare function resolveVaultRelative(value: string): string | null;
+export declare function extractHeadings(markdown: string): Set<string>;
+export declare function extractBlockIds(markdown: string): Set<string>;
+export declare function fragmentExists(note: ScannedNote, fragment: string): boolean;
+export declare function getExtension(filePath: string): string;

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@riebeckite/plugin-diagnostics",
+  "version": "0.0.1",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "source": "./index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "riebeckite-diagnostics": "./dist/bin.js"
+  },
+  "dependencies": {
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0",
+    "@riebeckite/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^24.5.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "README_ja.md",
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Rerurate514/riebeckite.git",
+    "directory": "packages/plugins/diagnostics"
+  },
+  "homepage": "https://github.com/Rerurate514/riebeckite#readme",
+  "bugs": {
+    "url": "https://github.com/Rerurate514/riebeckite/issues"
+  },
+  "description": "Content diagnostics for Riebeckite and Obsidian vaults.",
+  "keywords": [
+    "riebeckite",
+    "plugin",
+    "diagnostics",
+    "obsidian"
+  ],
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "node ../../../scripts/build_package.mjs"
+  }
+}