patram 0.8.0 → 0.9.0

package/lib/{render-rich-output.js → output/renderers/rich.js}

@@ -1,6 +1,6 @@
 /**
- * @import { CliColorMode } from './parse-cli-arguments.types.ts';
- * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView, QueryOutputView, RefsOutputView, ShowOutputView } from './output-view.types.ts';
+ * @import { CliColorMode } from '../../cli/arguments.types.ts';
+ * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView, QueryOutputView, RefsOutputView, ShowOutputView } from '../output-view.types.ts';
  */
 
 import { Ansis } from 'ansis';
@@ -8,13 +8,13 @@ import { Ansis } from 'ansis';
 import {
   formatOutputNodeMetadataRows,
   formatResolvedLinkMetadataRows,
-} from './format-output-metadata.js';
-import { formatNodeHeader } from './format-node-header.js';
-import { formatOutputItemBlock } from './format-output-item-block.js';
-import { layoutIncomingReferenceLines } from './layout-incoming-references.js';
-import { layoutIncomingSummaryLines } from './layout-incoming-summary-lines.js';
-import { layoutStoredQueries } from './layout-stored-queries.js';
-import { renderRichSource } from './render-rich-source.js';
+} from '../format-output-metadata.js';
+import { formatNodeHeader } from '../format-node-header.js';
+import { formatOutputItemBlock } from '../format-output-item-block.js';
+import { layoutIncomingReferenceLines } from '../layout-incoming-references.js';
+import { layoutIncomingSummaryLines } from '../layout-incoming-summary-lines.js';
+import { layoutStoredQueries } from '../layout-stored-queries.js';
+import { renderRichSource } from '../rich-source/render.js';
 
 const FULL_WIDTH_DIVIDER = ` ${'─'.repeat(78)} `;
 
@@ -112,6 +112,14 @@ async function renderRichShowOutput(output_view, render_options, ansi) {
     : '';
   const incoming_summary = renderRichIncomingSummary(output_view, ansi);
 
+  if (
+    document_summary.length === 0 &&
+    output_view.items.length === 0 &&
+    incoming_summary.length === 0
+  ) {
+    return `${rendered_source}\n`;
+  }
+
   /** @type {string[]} */
   const summary_items = [];
 
@@ -195,18 +203,26 @@ function formatRichResolvedLinkItem(output_item, ansi) {
  * @returns {string}
  */
 function renderRichIncomingSummary(output_view, ansi) {
+  if (!hasIncomingSummary(output_view.incoming_summary)) {
+    return '';
+  }
+
   const output_lines = layoutIncomingSummaryLines(output_view.incoming_summary);
   output_lines[0] = ansi.bold(output_lines[0]);
 
-  if (Object.keys(output_view.incoming_summary).length === 0) {
-    output_lines[1] = `  ${ansi.gray('none')}`;
-  }
-
   output_lines.push('', ansi.gray(`Hint: patram refs ${output_view.path}`));
 
   return output_lines.join('\n');
 }
 
+/**
+ * @param {Record<string, number>} incoming_summary
+ * @returns {boolean}
+ */
+function hasIncomingSummary(incoming_summary) {
+  return Object.keys(incoming_summary).length > 0;
+}
+
 /**
  * @param {boolean} color_enabled
  * @returns {Ansis}

package/lib/{resolve-check-target.js → output/resolve-check-target.js}

@@ -1,5 +1,5 @@
 /**
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { PatramDiagnostic } from '../config/load-patram-config.types.ts';
  */
 import { access, stat } from 'node:fs/promises';
 import { dirname, relative, resolve } from 'node:path';

package/lib/{render-rich-source.js → output/rich-source/render.js}

@@ -2,8 +2,8 @@
 /**
  * @import { ComarkElement, ComarkNode } from 'md4x';
  * @import { BundledLanguage } from 'shiki';
- * @import { CliColorMode } from './parse-cli-arguments.types.ts';
- * @import { OutputResolvedLinkItem, ShowOutputView } from './output-view.types.ts';
+ * @import { CliColorMode } from '../../cli/arguments.types.ts';
+ * @import { OutputResolvedLinkItem, ShowOutputView } from '../output-view.types.ts';
  */
 
 import { extname } from 'node:path';
@@ -969,8 +969,8 @@ function shouldRenderListItemGap(previous_item, next_item, has_blank_line_gap) {
   }
 
   return (
-    isSimpleTopLevelListItem(previous_item) &&
-    isSimpleTopLevelListItem(next_item)
+    isSingleParagraphTopLevelListItem(previous_item) &&
+    isSingleParagraphTopLevelListItem(next_item)
   );
 }
 
@@ -978,7 +978,7 @@ function shouldRenderListItemGap(previous_item, next_item, has_blank_line_gap) {
  * @param {ComarkElement} item_node
  * @returns {boolean}
  */
-function isSimpleTopLevelListItem(item_node) {
+function isSingleParagraphTopLevelListItem(item_node) {
   const item_children = getElementChildren(item_node);
 
   if (item_children.length !== 1) {
@@ -994,7 +994,7 @@ function isSimpleTopLevelListItem(item_node) {
     return false;
   }
 
-  return !extractInlineText(getElementChildren(paragraph_node)).includes('\n');
+  return true;
 }
 
 /**

package/lib/{show-document.js → output/show-document.js}

@@ -1,16 +1,16 @@
 /* eslint-disable max-lines */
 /**
- * @import { BuildGraphResult, GraphNode } from './build-graph.types.ts';
- * @import { PatramClaim } from './parse-claims.types.ts';
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { BuildGraphResult, GraphNode } from '../graph/build-graph.types.ts';
+ * @import { PatramClaim } from '../parse/parse-claims.types.ts';
+ * @import { PatramDiagnostic } from '../config/load-patram-config.types.ts';
  */
 
 import { readFile } from 'node:fs/promises';
 import { posix, relative, resolve } from 'node:path';
 
-import { resolveDocumentNodeId } from './build-graph-identity.js';
-import { inspectReverseReferences } from './inspect-reverse-references.js';
-import { parseSourceFile } from './parse-claims.js';
+import { resolveDocumentNodeId } from '../graph/build-graph-identity.js';
+import { inspectReverseReferences } from '../graph/inspect-reverse-references.js';
+import { parseSourceFile } from '../parse/parse-claims.js';
 
 /**
  * Show command document rendering.
@@ -20,12 +20,12 @@ import { parseSourceFile } from './parse-claims.js';
  *
  * Kind: output
  * Status: active
- * Tracked in: ../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../docs/decisions/show-output.md
- * Decided by: ../docs/decisions/source-rendering.md
+ * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * Decided by: ../../docs/decisions/show-output.md
+ * Decided by: ../../docs/decisions/source-rendering.md
  * @patram
  * @see {@link ./render-output-view.js}
- * @see {@link ../docs/decisions/show-output.md}
+ * @see {@link ../../docs/decisions/show-output.md}
  */
 
 /**
@@ -107,7 +107,7 @@ export async function loadShowOutput(
  * @param {string} source_text
  * @param {PatramClaim[]} claims
  * @param {BuildGraphResult} graph
- * @param {import('./build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
+ * @param {import('../graph/build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
  * @param {Record<string, GraphNode>} graph_nodes
  * @returns {{ incoming_summary: Record<string, number>, path: string, rendered_source: string, resolved_links: Array<{ label: string, reference: number, target: { kind?: string, path: string, status?: string, title: string } }>, source: string }}
  */
@@ -219,7 +219,7 @@ function renderResolvedSourceLine(
  * @param {string} source_file_path
  * @param {PatramClaim} claim
  * @param {number} reference
- * @param {import('./build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
+ * @param {import('../graph/build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
  * @param {Record<string, GraphNode>} graph_nodes
  * @returns {{ label: string, reference: number, target: { kind?: string, path: string, status?: string, title: string } }}
  */

package/lib/{render-output-view.js → output/view-model/index.js}

@@ -1,31 +1,12 @@
 /**
- * @import { BuildGraphResult, GraphNode } from './build-graph.types.ts';
- * @import { DerivedSummaryEvaluator } from './derived-summary.js';
- * @import { PatramRepoConfig } from './load-patram-config.types.ts';
- * @import { ParsedCliArguments } from './parse-cli-arguments.types.ts';
- * @import { OutputDerivedSummary, OutputMetadataField, OutputNodeItem, OutputResolvedLinkItem, OutputResolvedLinkTarget, OutputStoredQueryItem, OutputView, RefsOutputView, ResolvedOutputMode, ShowOutputView } from './output-view.types.ts';
+ * @import { BuildGraphResult, GraphNode } from '../../graph/build-graph.types.ts';
+ * @import { DerivedSummaryEvaluator } from '../derived-summary.js';
+ * @import { PatramRepoConfig } from '../../config/load-patram-config.types.ts';
+ * @import { OutputDerivedSummary, OutputMetadataField, OutputNodeItem, OutputResolvedLinkItem, OutputResolvedLinkTarget, OutputStoredQueryItem, OutputView, RefsOutputView, ShowOutputView } from '../output-view.types.ts';
  */
 /* eslint-disable max-lines */
 
-import { renderJsonOutput } from './render-json-output.js';
-import { renderPlainOutput } from './render-plain-output.js';
-import { renderRichOutput } from './render-rich-output.js';
-import { resolveDocumentNodeId } from './build-graph-identity.js';
-
-/**
- * Shared command output views.
- *
- * Normalizes `query`, `queries`, and `show` results into renderer-specific
- * output models.
- *
- * Kind: output
- * Status: active
- * Tracked in: ../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../docs/decisions/cli-output-architecture.md
- * @patram
- * @see {@link ./show-document.js}
- * @see {@link ../docs/decisions/cli-output-architecture.md}
- */
+import { resolveDocumentNodeId } from '../../graph/build-graph-identity.js';
 
 /**
  * Create a shared output view from one command result.
@@ -49,7 +30,7 @@ export function createOutputView(command_name, command_items, command_options) {
     );
   }
 
-  throw new Error(`Unsupported output view command "${command_name}".`);
+  throw new Error('Unsupported output view command.');
 }
 
 /**
@@ -132,33 +113,6 @@ export function createRefsOutputView(refs_output, command_options = {}) {
   };
 }
 
-/**
- * Render one shared output view through the resolved renderer.
- *
- * @param {OutputView} output_view
- * @param {ResolvedOutputMode} output_mode
- * @param {ParsedCliArguments} parsed_arguments
- * @returns {Promise<string>}
- */
-export async function renderOutputView(
-  output_view,
-  output_mode,
-  parsed_arguments,
-) {
-  if (output_mode.renderer_name === 'json') {
-    return renderJsonOutput(output_view);
-  }
-
-  if (output_mode.renderer_name === 'plain') {
-    return renderPlainOutput(output_view);
-  }
-
-  return renderRichOutput(output_view, {
-    color_enabled: output_mode.color_enabled,
-    color_mode: parsed_arguments.color_mode,
-  });
-}
-
 /**
  * @param {GraphNode[]} graph_nodes
  * @param {{ derived_summary_evaluator?: DerivedSummaryEvaluator, hints?: string[], limit?: number, offset?: number, repo_config?: PatramRepoConfig, total_count?: number }=} command_options

package/lib/{write-paged-output.js → output/write-paged-output.js}

@@ -42,10 +42,10 @@ async function writeOutputThroughPager(
 
   await writeToPagerInput(pager_process.stdin, output_text);
 
-  const [exit_code, signal_code] = await Promise.race([
-    close_promise,
-    error_promise,
-  ]);
+  const pager_result = /** @type {[number | null, NodeJS.Signals | null]} */ (
+    await Promise.race([close_promise, error_promise])
+  );
+  const [exit_code, signal_code] = pager_result;
 
   if (exit_code === 0) {
     return;
@@ -72,7 +72,11 @@ function writeToPagerInput(pager_input, output_text) {
         return;
       }
 
-      reject(error);
+      reject(
+        error instanceof Error
+          ? error
+          : new Error('Pager input failed with a non-Error rejection.'),
+      );
     });
     pager_input.end(output_text, 'utf8', resolve);
   });

package/lib/{claim-helpers.d.ts → parse/claim-helpers.d.ts}

@@ -16,5 +16,5 @@ export function createClaim(file_path: string, claim_number: number, claim_type:
  * @returns {string}
  */
 export function getFileExtension(file_path: string): string;
-import type { PatramClaimFields } from './parse-claims.types.ts';
-import type { PatramClaim } from './parse-claims.types.ts';
+import type { PatramClaimFields } from './parse-claims.types.d.ts';
+import type { PatramClaim } from './parse-claims.types.d.ts';

package/lib/{parse-jsdoc-claims.d.ts → parse/jsdoc/parse-jsdoc-claims.d.ts}

@@ -5,5 +5,5 @@
  * @returns {ParseSourceFileResult}
  */
 export function parseJsdocClaims(parse_input: ParseClaimsInput): ParseSourceFileResult;
-import type { ParseClaimsInput } from './parse-claims.types.ts';
-import type { ParseSourceFileResult } from './parse-claims.types.ts';
+import type { ParseClaimsInput } from '../parse-claims.types.d.ts';
+import type { ParseSourceFileResult } from '../parse-claims.types.d.ts';

package/lib/{parse-jsdoc-claims.js → parse/jsdoc/parse-jsdoc-claims.js}

@@ -1,20 +1,20 @@
 /**
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
- * @import { ParseClaimsInput, ParseSourceFileResult, PatramClaimFields } from './parse-claims.types.ts';
+ * @import { PatramDiagnostic } from '../../config/load-patram-config.types.ts';
+ * @import { ParseClaimsInput, ParseSourceFileResult, PatramClaimFields } from '../parse-claims.types.ts';
  */
 
 import {
   createClaim,
   getFileExtension,
   isPathLikeTarget,
-} from './claim-helpers.js';
-import { normalizeDirectiveName } from './parse-markdown-directives.js';
+} from '../claim-helpers.js';
+import { normalizeDirectiveName } from '../markdown/parse-markdown-directives.js';
 import { collectJsdocBlocks } from './parse-jsdoc-blocks.js';
 import {
   createJsdocProseClaimEntries,
   pushJsdocParagraph,
 } from './parse-jsdoc-prose.js';
-import { JSDOC_SOURCE_FILE_EXTENSIONS } from './source-file-defaults.js';
+import { JSDOC_SOURCE_FILE_EXTENSIONS } from '../../config/source-file-defaults.js';
 
 /**
  * JSDoc @patram claim parsing.
@@ -24,11 +24,11 @@ import { JSDOC_SOURCE_FILE_EXTENSIONS } from './source-file-defaults.js';
  *
  * Kind: parse
  * Status: active
- * Tracked in: ../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../docs/decisions/jsdoc-metadata-directive-syntax.md
+ * Tracked in: ../../../docs/plans/v0/source-anchor-dogfooding.md
+ * Decided by: ../../../docs/decisions/jsdoc-metadata-directive-syntax.md
  * @patram
- * @see {@link ./parse-claims.js}
- * @see {@link ../docs/decisions/jsdoc-metadata-directive-syntax.md}
+ * @see {@link ../parse-claims.js}
+ * @see {@link ../../../docs/decisions/jsdoc-metadata-directive-syntax.md}
  */
 
 const JSDOC_EXTENSIONS = new Set(JSDOC_SOURCE_FILE_EXTENSIONS);

package/lib/{parse-jsdoc-prose.d.ts → parse/jsdoc/parse-jsdoc-prose.d.ts}

@@ -25,4 +25,4 @@ export function createJsdocProseClaimEntries(file_path: string, prose_paragraphs
     claim_type: string;
     order: number;
 }>;
-import type { PatramClaimFields } from './parse-claims.types.ts';
+import type { PatramClaimFields } from '../parse-claims.types.d.ts';

package/lib/{parse-jsdoc-prose.js → parse/jsdoc/parse-jsdoc-prose.js}

@@ -1,5 +1,5 @@
 /**
- * @import { PatramClaimFields } from './parse-claims.types.ts';
+ * @import { PatramClaimFields } from '../parse-claims.types.ts';
  */
 
 const JSDOC_SENTENCE_PATTERN = /^(.+?[.!?])(?:\s+|$)([\s\S]*)$/du;

package/lib/{parse-markdown-claims.d.ts → parse/markdown/parse-markdown-claims.d.ts}

@@ -9,6 +9,6 @@ export function parseMarkdownClaims(parse_input: ParseClaimsInput, parse_options
     claims: PatramClaim[];
     diagnostics: PatramDiagnostic[];
 };
-import type { ParseClaimsInput } from './parse-claims.types.ts';
-import type { PatramClaim } from './parse-claims.types.ts';
-import type { PatramDiagnostic } from './load-patram-config.types.ts';
+import type { ParseClaimsInput } from '../parse-claims.types.d.ts';
+import type { PatramClaim } from '../parse-claims.types.d.ts';
+import type { PatramDiagnostic } from '../../config/load-patram-config.types.d.ts';

package/lib/{parse-markdown-claims.js → parse/markdown/parse-markdown-claims.js}

@@ -1,9 +1,9 @@
 /**
- * @import { PatramClaim, ParseClaimsInput, PatramClaimFields } from './parse-claims.types.ts';
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { PatramClaim, ParseClaimsInput, PatramClaimFields } from '../parse-claims.types.ts';
+ * @import { PatramDiagnostic } from '../../config/load-patram-config.types.ts';
  */
 
-import { createClaim, isPathLikeTarget } from './claim-helpers.js';
+import { createClaim, isPathLikeTarget } from '../claim-helpers.js';
 import {
   matchHiddenDirectiveFields,
   matchVisibleDirectiveFields,
@@ -18,12 +18,12 @@ import {
  *
  * Kind: parse
  * Status: active
- * Tracked in: ../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../docs/decisions/markdown-metadata-directive-syntax.md
- * Decided by: ../docs/decisions/markdown-link-claim-scope.md
+ * Tracked in: ../../../docs/plans/v0/source-anchor-dogfooding.md
+ * Decided by: ../../../docs/decisions/markdown-metadata-directive-syntax.md
+ * Decided by: ../../../docs/decisions/markdown-link-claim-scope.md
  * @patram
- * @see {@link ./parse-claims.js}
- * @see {@link ../docs/decisions/markdown-metadata-directive-syntax.md}
+ * @see {@link ../parse-claims.js}
+ * @see {@link ../../../docs/decisions/markdown-metadata-directive-syntax.md}
  */
 
 const HEADING_PATTERN = /^#\s+(.+)$/du;

package/lib/{parse-markdown-directives.d.ts → parse/markdown/parse-markdown-directives.d.ts}

@@ -30,5 +30,5 @@ export function matchHiddenDirectiveFields(file_path: string, line: string, line
  * @returns {string}
  */
 export function normalizeDirectiveName(directive_label: string): string;
-import type { PatramDiagnostic } from './load-patram-config.types.ts';
-import type { PatramClaimFields } from './parse-claims.types.ts';
+import type { PatramDiagnostic } from '../../config/load-patram-config.types.d.ts';
+import type { PatramClaimFields } from '../parse-claims.types.d.ts';

package/lib/{parse-markdown-directives.js → parse/markdown/parse-markdown-directives.js}

@@ -1,9 +1,9 @@
 /**
- * @import { MarkdownDirectiveStyle, PatramClaimFields } from './parse-claims.types.ts';
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { MarkdownDirectiveStyle, PatramClaimFields } from '../parse-claims.types.ts';
+ * @import { PatramDiagnostic } from '../../config/load-patram-config.types.ts';
  */
 
-import { parseYamlDirectiveFields } from './parse-yaml-claims.js';
+import { parseYamlDirectiveFields } from '../yaml/parse-yaml-claims.js';
 
 const FRONT_MATTER_BOUNDARY_PATTERN = /^---$/du;
 const MARKDOWN_HIDDEN_DIRECTIVE_PATTERN =

package/lib/{parse-claims.d.ts → parse/parse-claims.d.ts}

@@ -8,16 +8,6 @@
 export function parseSourceFile(parse_input: ParseClaimsInput, parse_options?: {
     multi_value_directive_names?: ReadonlySet<string>;
 }): ParseSourceFileResult;
-/**
- * Parse a file into neutral Patram claims.
- *
- * @param {ParseClaimsInput} parse_input
- * @param {{ multi_value_directive_names?: ReadonlySet<string> }} [parse_options]
- * @returns {PatramClaim[]}
- */
-export function parseClaims(parse_input: ParseClaimsInput, parse_options?: {
-    multi_value_directive_names?: ReadonlySet<string>;
-}): PatramClaim[];
 /**
  * Build parser options from repo config.
  *
@@ -35,6 +25,7 @@ export function createParseOptions(repo_config: {
 } | undefined): {
     multi_value_directive_names: Set<string>;
 };
-import type { ParseClaimsInput } from './parse-claims.types.ts';
-import type { ParseSourceFileResult } from './parse-claims.types.ts';
-import type { PatramClaim } from './parse-claims.types.ts';
+export type ClaimOrigin = import("./parse-claims.types.d.ts").ClaimOrigin;
+export type ParseClaimsInput = import("./parse-claims.types.d.ts").ParseClaimsInput;
+export type ParseSourceFileResult = import("./parse-claims.types.d.ts").ParseSourceFileResult;
+export type PatramClaim = import("./parse-claims.types.d.ts").PatramClaim;

package/lib/{parse-claims.js → parse/parse-claims.js}

@@ -1,15 +1,18 @@
-/**
- * @import { ParseClaimsInput, ParseSourceFileResult, PatramClaim } from './parse-claims.types.ts';
- */
-
 import { getFileExtension } from './claim-helpers.js';
-import { parseJsdocClaims } from './parse-jsdoc-claims.js';
-import { parseMarkdownClaims } from './parse-markdown-claims.js';
-import { parseYamlClaims } from './parse-yaml-claims.js';
+import { parseJsdocClaims } from './jsdoc/parse-jsdoc-claims.js';
+import { parseMarkdownClaims } from './markdown/parse-markdown-claims.js';
+import { parseYamlClaims } from './yaml/parse-yaml-claims.js';
 import {
   MARKDOWN_SOURCE_FILE_EXTENSIONS,
   YAML_SOURCE_FILE_EXTENSIONS,
-} from './source-file-defaults.js';
+} from '../config/source-file-defaults.js';
+
+/**
+ * @typedef {import('./parse-claims.types.ts').ClaimOrigin} ClaimOrigin
+ * @typedef {import('./parse-claims.types.ts').ParseClaimsInput} ParseClaimsInput
+ * @typedef {import('./parse-claims.types.ts').ParseSourceFileResult} ParseSourceFileResult
+ * @typedef {import('./parse-claims.types.ts').PatramClaim} PatramClaim
+ */
 
 /**
  * Source claim dispatch.
@@ -19,14 +22,14 @@ import {
  *
  * Kind: parse
  * Status: active
- * Uses Term: ../docs/reference/terms/claim.md
- * Uses Term: ../docs/reference/terms/document.md
- * Tracked in: ../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../docs/decisions/jsdoc-metadata-directive-syntax.md
- * Implements: ../docs/tasks/v0/parse-claims.md
+ * Uses Term: ../../docs/reference/terms/claim.md
+ * Uses Term: ../../docs/reference/terms/document.md
+ * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * Decided by: ../../docs/decisions/jsdoc-metadata-directive-syntax.md
+ * Implements: ../../docs/tasks/v0/parse-claims.md
  * @patram
- * @see {@link ./parse-markdown-claims.js}
- * @see {@link ./parse-jsdoc-claims.js}
+ * @see {@link ./markdown/parse-markdown-claims.js}
+ * @see {@link ./jsdoc/parse-jsdoc-claims.js}
  */
 
 const MARKDOWN_EXTENSIONS = new Set(MARKDOWN_SOURCE_FILE_EXTENSIONS);
@@ -53,17 +56,6 @@ export function parseSourceFile(parse_input, parse_options) {
   return parseJsdocClaims(parse_input);
 }
 
-/**
- * Parse a file into neutral Patram claims.
- *
- * @param {ParseClaimsInput} parse_input
- * @param {{ multi_value_directive_names?: ReadonlySet<string> }} [parse_options]
- * @returns {PatramClaim[]}
- */
-export function parseClaims(parse_input, parse_options) {
-  return parseSourceFile(parse_input, parse_options).claims;
-}
-
 /**
  * Build parser options from repo config.
  *

package/lib/{parse-claims.types.d.ts → parse/parse-claims.types.d.ts}

@@ -1,4 +1,4 @@
-import type { PatramDiagnostic } from './load-patram-config.types.ts';
+import type { PatramDiagnostic } from '../config/load-patram-config.types.d.ts';
 export type MarkdownDirectiveStyle = 'front_matter' | 'visible_line' | 'list_item' | 'hidden_tag';
 export interface ParseClaimsInput {
     path: string;

package/lib/{tagged-fenced-block-error.d.ts → parse/tagged-fenced/tagged-fenced-block-error.d.ts}

@@ -1,5 +1,5 @@
 /**
- * @import { TaggedFencedBlockError } from './tagged-fenced-blocks.types.ts';
+ * @import { TaggedFencedBlockError } from './tagged-fenced-blocks.types.d.ts';
  */
 /**
  * @param {string} code
@@ -7,4 +7,4 @@
  * @returns {TaggedFencedBlockError}
  */
 export function createTaggedFencedBlockError(code: string, message: string): TaggedFencedBlockError;
-import type { TaggedFencedBlockError } from './tagged-fenced-blocks.types.ts';
+import type { TaggedFencedBlockError } from './tagged-fenced-blocks.types.d.ts';

package/lib/{tagged-fenced-block-parser.d.ts → parse/tagged-fenced/tagged-fenced-block-parser.d.ts}

@@ -56,6 +56,6 @@ export type TaggedBlockScannerState = {
     pending_tag_set: PendingTagSet | null;
     title: string;
 };
-import type { TaggedFencedBlocksInput } from './tagged-fenced-blocks.types.ts';
-import type { TaggedFencedBlockFile } from './tagged-fenced-blocks.types.ts';
-import type { TaggedFencedBlock } from './tagged-fenced-blocks.types.ts';
+import type { TaggedFencedBlocksInput } from './tagged-fenced-blocks.types.d.ts';
+import type { TaggedFencedBlockFile } from './tagged-fenced-blocks.types.d.ts';
+import type { TaggedFencedBlock } from './tagged-fenced-blocks.types.d.ts';

package/lib/{tagged-fenced-blocks.d.ts → parse/tagged-fenced/tagged-fenced-blocks.d.ts}

@@ -6,10 +6,10 @@
  *
  * Kind: parse
  * Status: active
- * Tracked in: ../docs/plans/v0/tagged-fenced-block-extraction.md
- * Decided by: ../docs/decisions/tagged-fenced-block-extraction.md
+ * Tracked in: ../../../docs/plans/v0/tagged-fenced-block-extraction.md
+ * Decided by: ../../../docs/decisions/tagged-fenced-block-extraction.md
  * @patram
- * @see {@link ../docs/decisions/tagged-fenced-block-extraction.md}
+ * @see {@link ../../../docs/decisions/tagged-fenced-block-extraction.md}
  */
 /**
  * @param {TaggedFencedBlocksInput} input
@@ -33,7 +33,7 @@ export function selectTaggedBlocks(blocks: TaggedFencedBlock[], criteria: Tagged
  * @returns {TaggedFencedBlock}
  */
 export function selectTaggedBlock(blocks: TaggedFencedBlock[], criteria: TaggedFencedBlockCriteria): TaggedFencedBlock;
-import type { TaggedFencedBlocksInput } from './tagged-fenced-blocks.types.ts';
-import type { TaggedFencedBlockFile } from './tagged-fenced-blocks.types.ts';
-import type { TaggedFencedBlock } from './tagged-fenced-blocks.types.ts';
-import type { TaggedFencedBlockCriteria } from './tagged-fenced-blocks.types.ts';
+import type { TaggedFencedBlocksInput } from './tagged-fenced-blocks.types.d.ts';
+import type { TaggedFencedBlockFile } from './tagged-fenced-blocks.types.d.ts';
+import type { TaggedFencedBlock } from './tagged-fenced-blocks.types.d.ts';
+import type { TaggedFencedBlockCriteria } from './tagged-fenced-blocks.types.d.ts';

package/lib/{tagged-fenced-blocks.js → parse/tagged-fenced/tagged-fenced-blocks.js}

@@ -20,10 +20,10 @@ import { extractTaggedFencedBlocksFromSource } from './tagged-fenced-block-parse
  *
  * Kind: parse
  * Status: active
- * Tracked in: ../docs/plans/v0/tagged-fenced-block-extraction.md
- * Decided by: ../docs/decisions/tagged-fenced-block-extraction.md
+ * Tracked in: ../../../docs/plans/v0/tagged-fenced-block-extraction.md
+ * Decided by: ../../../docs/decisions/tagged-fenced-block-extraction.md
  * @patram
- * @see {@link ../docs/decisions/tagged-fenced-block-extraction.md}
+ * @see {@link ../../../docs/decisions/tagged-fenced-block-extraction.md}
  */
 
 /**

package/lib/{parse-yaml-claims.d.ts → parse/yaml/parse-yaml-claims.d.ts}

@@ -32,7 +32,7 @@ export function parseYamlDirectiveFields(parse_input: {
     diagnostics: PatramDiagnostic[];
     directive_fields: PatramClaimFields[];
 };
-import type { ParseClaimsInput } from './parse-claims.types.ts';
-import type { ParseSourceFileResult } from './parse-claims.types.ts';
-import type { PatramDiagnostic } from './load-patram-config.types.ts';
-import type { PatramClaimFields } from './parse-claims.types.ts';
+import type { ParseClaimsInput } from '../parse-claims.types.d.ts';
+import type { ParseSourceFileResult } from '../parse-claims.types.d.ts';
+import type { PatramDiagnostic } from '../../config/load-patram-config.types.d.ts';
+import type { PatramClaimFields } from '../parse-claims.types.d.ts';