@linloir/limr 0.1.0 → 1.0.1

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { k as SourceRange, f as DocumentSnapshot, h as SelectionSnapshot, g as HighlightData, A as Annotation, a as AnnotationAnchor, M as MarkdownNode } from '../engine-43u8B4yt.js';
-export { b as AnnotationOccurrence, B as Block, D as Diagnostic, c as DocumentEngine, d as DocumentMetrics, e as DocumentOptions, H as Heading, P as ParseContext, R as Rect, S as SelectionResult, i as SourcePoint, j as SourcePosition, l as SyntaxExtension, m as createDocument, r as replaceExtension } from '../engine-43u8B4yt.js';
+import { m as SourceRange, f as DocumentSnapshot, j as SelectionSnapshot, b as AnnotationOccurrence, g as HighlightData, A as Annotation, a as AnnotationAnchor, M as MarkdownNode } from '../knuth-plass-C8mgFm7W.js';
+export { B as Block, D as Diagnostic, c as DocumentEngine, d as DocumentMetrics, e as DocumentOptions, H as Heading, K as KnuthPlassOptions, L as LineBreak, h as LineItem, P as ParagraphLayout, i as ParseContext, R as Rect, S as SelectionResult, k as SourcePoint, l as SourcePosition, n as SyntaxExtension, o as createDocument, p as knuthPlass, q as prepareKnuthPlass, r as replaceExtension, t as texBadness } from '../knuth-plass-C8mgFm7W.js';
 import 'micromark-util-types';
 import 'mdast-util-from-markdown';
 
@@ -42,6 +42,9 @@ declare class ResourceCache<T = unknown> {
 
 declare const defaultHighlight: Readonly<HighlightData>;
 declare const sameRange: (a: SourceRange, b: SourceRange) => boolean;
+/** Embedded references quote their nearest text block; keep the marker's own
+ * range intact for source mapping, insertion and selection. */
+declare function annotationReferenceRange(document: DocumentSnapshot, occurrence: AnnotationOccurrence): SourceRange;
 /** Resolve persisted anchors once against the current source. */
 declare function resolveAnnotationAnchors(annotation: Annotation, document: DocumentSnapshot): AnnotationAnchor[];
 
@@ -51,4 +54,4 @@ declare function rangeOf(node: MarkdownNode): SourceRange;
 declare function intersects(a: SourceRange, b: SourceRange): boolean;
 declare function safeUrl(value: unknown, image?: boolean): string | undefined;
 
-export { Annotation, AnnotationAnchor, DocumentSnapshot, HighlightData, LruCache, MarkdownNode, ResourceCache, SelectionSnapshot, SourceRange, type TextMapping, defaultHighlight, intersects, mapText, rangeOf, resolveAnnotationAnchors, safeUrl, sameRange, selectionFromRange, textContent, walk };
+export { Annotation, AnnotationAnchor, AnnotationOccurrence, DocumentSnapshot, HighlightData, LruCache, MarkdownNode, ResourceCache, SelectionSnapshot, SourceRange, type TextMapping, annotationReferenceRange, defaultHighlight, intersects, mapText, rangeOf, resolveAnnotationAnchors, safeUrl, sameRange, selectionFromRange, textContent, walk };

package/dist/core/index.js

@@ -1,18 +1,24 @@
 import {
   DocumentEngine,
+  annotationReferenceRange,
   createDocument,
   defaultHighlight,
-  intersects,
   mapText,
-  rangeOf,
   replaceExtension,
   resolveAnnotationAnchors,
-  safeUrl,
   sameRange,
-  selectionFromRange,
+  selectionFromRange
+} from "../chunk-BG5QUQFR.js";
+import {
+  intersects,
+  knuthPlass,
+  prepareKnuthPlass,
+  rangeOf,
+  safeUrl,
+  texBadness,
   textContent,
   walk
-} from "../chunk-7JF5HHVF.js";
+} from "../chunk-FJZCQY2S.js";
 import {
   LruCache,
   ResourceCache
@@ -21,16 +27,20 @@ export {
   DocumentEngine,
   LruCache,
   ResourceCache,
+  annotationReferenceRange,
   createDocument,
   defaultHighlight,
   intersects,
+  knuthPlass,
   mapText,
+  prepareKnuthPlass,
   rangeOf,
   replaceExtension,
   resolveAnnotationAnchors,
   safeUrl,
   sameRange,
   selectionFromRange,
+  texBadness,
   textContent,
   walk
 };

package/dist/extensions/index.d.ts

@@ -1,8 +1,8 @@
-import { N as NodeRenderer, f as AnnotationType, R as RendererExtension, i as MarkdownProps, S as SelectionAction } from '../translations-BliabrPd.js';
-export { n as TranslationMode, o as TranslationsOptions, t as translations } from '../translations-BliabrPd.js';
+import { N as NodeRenderer, R as RendererExtension, f as AnnotationType, i as MarkdownProps, S as SelectionAction } from '../translations-BXzSwLBJ.js';
+export { p as TranslationMode, q as TranslationsOptions, t as translations } from '../translations-BXzSwLBJ.js';
 import { KatexOptions } from 'katex';
 import * as react from 'react';
-import '../engine-43u8B4yt.js';
+import '../knuth-plass-C8mgFm7W.js';
 import 'micromark-util-types';
 import 'mdast-util-from-markdown';
 
@@ -12,9 +12,10 @@ interface BlockExtensionOptions {
     tags?: readonly string[];
     directives?: readonly string[];
     selection?: 'content' | 'atomic';
+    streaming?: RendererExtension['streaming'];
 }
 /** A tag/directive adapter with original source positions and streaming recovery. */
-declare function defineBlock({ name, component, tags, directives, selection }: BlockExtensionOptions): RendererExtension;
+declare function defineBlock({ name, component, tags, directives, selection, streaming }: BlockExtensionOptions): RendererExtension;
 declare function defineAnnotation<T>(type: AnnotationType<T>): RendererExtension;
 declare function defineExtension(extension: RendererExtension): RendererExtension;
 
@@ -28,6 +29,30 @@ interface MathOptions {
 }
 declare function math(options?: MathOptions): RendererExtension;
 
+/** Lazy, atomic diagrams. An unclosed streaming fence never reaches Mermaid. */
+declare function mermaid(): RendererExtension;
+
+declare function calloutType(value: string): string;
+/** Obsidian blockquotes and LiMR ::callout share the same renderer and AST. */
+declare function callout(options?: {
+    component?: NodeRenderer;
+}): RendererExtension;
+
+interface InlineHighlightOptions {
+    color?: string;
+    component?: NodeRenderer;
+}
+/** Markdown-authored highlights share the normal paint/hover/copy machinery,
+ * while their source remains the authority for editing. */
+declare function inlineHighlights(options?: InlineHighlightOptions): RendererExtension;
+
+interface FootnoteData {
+    body: string;
+}
+/** GFM definitions keep their AST identity for incremental parsing, but their
+ * references use the same marker/sidebar/overlay contract as other modules. */
+declare function footnotes(options?: Partial<AnnotationType<FootnoteData>>): RendererExtension;
+
 interface CodeHighlightOptions {
     languages?: readonly string[];
     lightTheme?: string;
@@ -127,4 +152,4 @@ declare function highlightPalette(options?: HighlightOptions): SelectionAction;
 declare function highlightSelection(): SelectionAction;
 declare function deleteAnnotations(): SelectionAction;
 
-export { AnnotationMarkdown, type BlockExtensionOptions, type CitationData, type CodeHighlightOptions, type FiguresOptions, type HighlightOptions, type MathOptions, type VideoOptions, citation, codeHighlight, copyText, defineAnnotation, defineBlock, defineExtension, definition, deleteAnnotations, extras, figures, gfm, highlightColors, highlightPalette, highlightSelection, math, preloadMath, question, standard, video };
+export { AnnotationMarkdown, type BlockExtensionOptions, type CitationData, type CodeHighlightOptions, type FiguresOptions, type FootnoteData, type HighlightOptions, type InlineHighlightOptions, type MathOptions, type VideoOptions, callout, calloutType, citation, codeHighlight, copyText, defineAnnotation, defineBlock, defineExtension, definition, deleteAnnotations, extras, figures, footnotes, gfm, highlightColors, highlightPalette, highlightSelection, inlineHighlights, math, mermaid, preloadMath, question, standard, video };

package/dist/extensions/index.js

@@ -1,6 +1,8 @@
-import "../chunk-V2OG4Y3F.js";
+import "../chunk-FSI5OTBW.js";
 import {
   AnnotationMarkdown,
+  callout,
+  calloutType,
   citation,
   codeHighlight,
   copyText,
@@ -11,21 +13,28 @@ import {
   deleteAnnotations,
   extras,
   figures,
+  footnotes,
   gfm,
   highlightColors,
   highlightPalette,
   highlightSelection,
+  inlineHighlights,
   math,
+  mermaid,
   preloadMath,
   question,
   standard,
   translations,
   video
-} from "../chunk-65V5OZ4G.js";
-import "../chunk-7JF5HHVF.js";
+} from "../chunk-SUAAUGAX.js";
+import "../chunk-BG5QUQFR.js";
+import "../chunk-BVHHOVMT.js";
+import "../chunk-FJZCQY2S.js";
 import "../chunk-6N6TFHEN.js";
 export {
   AnnotationMarkdown,
+  callout,
+  calloutType,
   citation,
   codeHighlight,
   copyText,
@@ -36,11 +45,14 @@ export {
   deleteAnnotations,
   extras,
   figures,
+  footnotes,
   gfm,
   highlightColors,
   highlightPalette,
   highlightSelection,
+  inlineHighlights,
   math,
+  mermaid,
   preloadMath,
   question,
   standard,

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { A as Annotation, a as AnnotationAnchor, b as AnnotationOccurrence, B as Block, D as Diagnostic, c as DocumentEngine, d as DocumentMetrics, e as DocumentOptions, f as DocumentSnapshot, H as Heading, g as HighlightData, M as MarkdownNode, P as ParseContext, R as Rect, S as SelectionResult, h as SelectionSnapshot, i as SourcePoint, j as SourcePosition, k as SourceRange, l as SyntaxExtension, m as createDocument, r as replaceExtension } from './engine-43u8B4yt.js';
-export { LruCache, ResourceCache, TextMapping, defaultHighlight, intersects, mapText, rangeOf, resolveAnnotationAnchors, safeUrl, sameRange, selectionFromRange, textContent, walk } from './core/index.js';
-export { A as ActionContext, a as AnnotationContentProps, b as AnnotationExpansion, c as AnnotationOverlayCardProps, d as AnnotationPresentation, e as AnnotationSidebarPreviewProps, f as AnnotationType, D as DocumentCommands, g as DocumentProvider, h as DocumentProviderProps, L as LiMRLocale, M as Markdown, i as MarkdownProps, N as NodeRenderer, j as NodeRendererProps, R as RendererExtension, k as RendererParameters, S as SelectionAction, l as StyledProps, T as TextToken, m as ToolbarActionContext, n as TranslationMode, o as TranslationsOptions, V as ViewConfiguration, t as translations, u as useAnchor, p as useAnnotation, q as useAnnotationState, r as useAnnotations, s as useDocument, v as useDocumentSelector, w as useLiMR, x as useRendererParameter, y as useSelection } from './translations-BliabrPd.js';
+export { A as Annotation, a as AnnotationAnchor, b as AnnotationOccurrence, B as Block, D as Diagnostic, c as DocumentEngine, d as DocumentMetrics, e as DocumentOptions, f as DocumentSnapshot, H as Heading, g as HighlightData, K as KnuthPlassOptions, L as LineBreak, h as LineItem, M as MarkdownNode, P as ParagraphLayout, i as ParseContext, R as Rect, S as SelectionResult, j as SelectionSnapshot, k as SourcePoint, l as SourcePosition, m as SourceRange, n as SyntaxExtension, o as createDocument, p as knuthPlass, q as prepareKnuthPlass, r as replaceExtension, t as texBadness } from './knuth-plass-C8mgFm7W.js';
+export { LruCache, ResourceCache, TextMapping, annotationReferenceRange, defaultHighlight, intersects, mapText, rangeOf, resolveAnnotationAnchors, safeUrl, sameRange, selectionFromRange, textContent, walk } from './core/index.js';
+export { A as ActionContext, a as AnnotationContentProps, b as AnnotationExpansion, c as AnnotationOverlayCardProps, d as AnnotationPresentation, e as AnnotationSidebarPreviewProps, f as AnnotationType, D as DocumentCommands, g as DocumentProvider, h as DocumentProviderProps, L as LiMRLocale, M as Markdown, i as MarkdownProps, N as NodeRenderer, j as NodeRendererProps, R as RendererExtension, k as RendererOverride, l as RendererParameters, S as SelectionAction, m as StreamEffect, n as StyledProps, T as TextToken, o as ToolbarActionContext, p as TranslationMode, q as TranslationsOptions, r as TypographyMode, V as ViewConfiguration, t as translations, u as useAnchor, s as useAnnotation, v as useAnnotationState, w as useAnnotations, x as useDocument, y as useDocumentSelector, z as useLiMR, B as useLocale, C as useRendererParameter, E as useSelection } from './translations-BXzSwLBJ.js';
 export { AnnotationCard, AnnotationCardProps, AnnotationContent, AnnotationGroup, AnnotationOverlay, AnnotationOverlayProps, AnnotationSidebar, AnnotationSidebarProps, InlineMarker, InlineMarkerProps, Reader, ReaderProps, SelectionToolbar, SelectionToolbarProps, SidebarItem, SidebarPositioner, TableOfContents, TableOfContentsProps, ToolIcon, ToolIconName, alignSidebar, chinese, english } from './react/index.js';
-export { AnnotationMarkdown, BlockExtensionOptions, CitationData, CodeHighlightOptions, FiguresOptions, HighlightOptions, MathOptions, VideoOptions, citation, codeHighlight, copyText, defineAnnotation, defineBlock, defineExtension, definition, deleteAnnotations, extras, figures, gfm, highlightColors, highlightPalette, highlightSelection, math, preloadMath, question, standard, video } from './extensions/index.js';
+export { AnnotationMarkdown, BlockExtensionOptions, CitationData, CodeHighlightOptions, FiguresOptions, FootnoteData, HighlightOptions, InlineHighlightOptions, MathOptions, VideoOptions, callout, calloutType, citation, codeHighlight, copyText, defineAnnotation, defineBlock, defineExtension, definition, deleteAnnotations, extras, figures, footnotes, gfm, highlightColors, highlightPalette, highlightSelection, inlineHighlights, math, mermaid, preloadMath, question, standard, video } from './extensions/index.js';
 import 'micromark-util-types';
 import 'mdast-util-from-markdown';
 import 'react';

package/dist/index.js

@@ -1,4 +1,4 @@
-import "./chunk-V2OG4Y3F.js";
+import "./chunk-FSI5OTBW.js";
 import {
   AnnotationContent,
   AnnotationGroup,
@@ -8,7 +8,7 @@ import {
   SelectionToolbar,
   TableOfContents,
   alignSidebar
-} from "./chunk-ETHLPBKQ.js";
+} from "./chunk-GU2RPESF.js";
 import {
   AnnotationCard,
   AnnotationMarkdown,
@@ -16,6 +16,8 @@ import {
   InlineMarker,
   Markdown,
   ToolIcon,
+  callout,
+  calloutType,
   chinese,
   citation,
   codeHighlight,
@@ -28,11 +30,14 @@ import {
   english,
   extras,
   figures,
+  footnotes,
   gfm,
   highlightColors,
   highlightPalette,
   highlightSelection,
+  inlineHighlights,
   math,
+  mermaid,
   preloadMath,
   question,
   standard,
@@ -44,25 +49,33 @@ import {
   useDocument,
   useDocumentSelector,
   useLiMR,
+  useLocale,
   useRendererParameter,
   useSelection,
   video
-} from "./chunk-65V5OZ4G.js";
+} from "./chunk-SUAAUGAX.js";
 import {
   DocumentEngine,
+  annotationReferenceRange,
   createDocument,
   defaultHighlight,
-  intersects,
   mapText,
-  rangeOf,
   replaceExtension,
   resolveAnnotationAnchors,
-  safeUrl,
   sameRange,
-  selectionFromRange,
+  selectionFromRange
+} from "./chunk-BG5QUQFR.js";
+import "./chunk-BVHHOVMT.js";
+import {
+  intersects,
+  knuthPlass,
+  prepareKnuthPlass,
+  rangeOf,
+  safeUrl,
+  texBadness,
   textContent,
   walk
-} from "./chunk-7JF5HHVF.js";
+} from "./chunk-FJZCQY2S.js";
 import {
   LruCache,
   ResourceCache
@@ -85,6 +98,9 @@ export {
   TableOfContents,
   ToolIcon,
   alignSidebar,
+  annotationReferenceRange,
+  callout,
+  calloutType,
   chinese,
   citation,
   codeHighlight,
@@ -99,14 +115,19 @@ export {
   english,
   extras,
   figures,
+  footnotes,
   gfm,
   highlightColors,
   highlightPalette,
   highlightSelection,
+  inlineHighlights,
   intersects,
+  knuthPlass,
   mapText,
   math,
+  mermaid,
   preloadMath,
+  prepareKnuthPlass,
   question,
   rangeOf,
   replaceExtension,
@@ -115,6 +136,7 @@ export {
   sameRange,
   selectionFromRange,
   standard,
+  texBadness,
   textContent,
   translations,
   useAnchor,
@@ -124,6 +146,7 @@ export {
   useDocument,
   useDocumentSelector,
   useLiMR,
+  useLocale,
   useRendererParameter,
   useSelection,
   video,

package/dist/{engine-43u8B4yt.d.ts → knuth-plass-C8mgFm7W.d.ts}

@@ -27,6 +27,8 @@ interface MarkdownNode {
     attributeNodes?: Record<string, MarkdownNode>;
     inline?: boolean;
     selection?: 'content' | 'atomic';
+    /** The opening syntax is known but its closing delimiter has not arrived. */
+    incomplete?: boolean;
     [key: string]: unknown;
 }
 interface ParseContext {
@@ -41,6 +43,8 @@ interface SyntaxExtension {
     mdast?: readonly Extension$1[];
     tags?: readonly string[];
     directives?: readonly string[];
+    /** Directive bodies are literal source (for example code or LaTeX). */
+    literal?: boolean;
     selection?: 'content' | 'atomic';
     transform?: (root: MarkdownNode, context: ParseContext) => void;
     display?: 'block' | 'inline' | 'auto';
@@ -74,12 +78,16 @@ interface AnnotationOccurrence extends AnnotationAnchor {
     id: string;
     annotationIds: readonly string[];
     embedded?: boolean;
+    /** Optional referenced text range, distinct from the marker's source range. */
+    referenceRange?: SourceRange;
 }
 /** Data for the built-in `highlight` annotation type. */
 interface HighlightData {
     color?: string;
     style?: 'background' | 'underline' | 'dotted' | 'wavy';
     hidden?: boolean;
+    /** Authored in Markdown: the default toolbar offers copying without editing. */
+    readOnly?: boolean;
 }
 interface Block {
     id: string;
@@ -126,6 +134,8 @@ interface SelectionResult {
 interface SelectionSnapshot {
     documentId: string;
     revision: number;
+    /** Readable selected text; the browser adapter substitutes complete original
+     * source (including delimiters) for selected atomic content once settled. */
     text: string;
     quality: 'exact' | 'atomic' | 'unmapped';
     raw: SelectionResult;
@@ -156,6 +166,9 @@ declare class DocumentEngine {
     private listeners;
     private definitionSignature;
     private recoveryOffset;
+    private lines;
+    private facts;
+    private relevant;
     constructor(source?: string, options?: DocumentOptions);
     getSnapshot: () => DocumentSnapshot;
     subscribe: (listener: () => void) => (() => void);
@@ -169,4 +182,57 @@ declare class DocumentEngine {
 declare function createDocument(source?: string, options?: DocumentOptions): DocumentEngine;
 declare function replaceExtension<T extends SyntaxExtension>(extensions: readonly T[], replacement: T): T[];
 
-export { type Annotation as A, type Block as B, type Diagnostic as D, type Heading as H, type MarkdownNode as M, type ParseContext as P, type Rect as R, type SelectionResult as S, type AnnotationAnchor as a, type AnnotationOccurrence as b, DocumentEngine as c, type DocumentMetrics as d, type DocumentOptions as e, type DocumentSnapshot as f, type HighlightData as g, type SelectionSnapshot as h, type SourcePoint as i, type SourcePosition as j, type SourceRange as k, type SyntaxExtension as l, createDocument as m, replaceExtension as r };
+/** TeX82's paragraph model (tex.web, sections 815–873): boxes, glue,
+ * discretionary penalties, four fitness classes and a minimum-demerit path.
+ * Widths are converted to scaled units for TeX's integer badness calculation. */
+type LineItem = {
+    type: 'box';
+    width: number;
+} | {
+    type: 'glue';
+    width: number;
+    stretch: number;
+    shrink: number;
+    infinite?: boolean;
+} | {
+    type: 'penalty';
+    width: number;
+    penalty: number;
+    flagged?: boolean;
+    automatic?: boolean;
+};
+interface KnuthPlassOptions {
+    pretolerance?: number;
+    tolerance?: number;
+    linePenalty?: number;
+    hyphenPenalty?: number;
+    adjacentDemerits?: number;
+    doubleHyphenDemerits?: number;
+    finalHyphenDemerits?: number;
+    /** Extra stretch in CSS pixels in the emergency pass, as in TeX. */
+    emergencyStretch?: number;
+    looseness?: number;
+    /** Default: Knuth–Liang en-US patterns. Return pieces that join to the word. */
+    hyphenate?: false | ((word: string) => readonly string[]);
+}
+interface LineBreak {
+    index: number;
+    start: number;
+    ratio: number;
+    fitness: number;
+}
+interface ParagraphLayout {
+    lines: LineBreak[];
+    demerits: number;
+    pass: 'pretolerance' | 'tolerance' | 'emergency' | 'final';
+}
+/** The integer approximation used by TeX, including its saturation at 10000. */
+declare function texBadness(amount: number, available: number): number;
+/** Prefix sums and safe active-node pruning remove repeated line scans. With
+ * constant line lengths and zero looseness, equal fitness is an exact shared
+ * state: future cost is independent of line count. No beam or word limit. */
+declare function knuthPlass(items: readonly LineItem[], lengths: number | readonly number[], options?: KnuthPlassOptions): ParagraphLayout;
+/** Retains width/stretch prefix sums across responsive layouts of the same text. */
+declare function prepareKnuthPlass(items: readonly LineItem[]): (lengths: number | readonly number[], options?: KnuthPlassOptions) => ParagraphLayout;
+
+export { type Annotation as A, type Block as B, type Diagnostic as D, type Heading as H, type KnuthPlassOptions as K, type LineBreak as L, type MarkdownNode as M, type ParagraphLayout as P, type Rect as R, type SelectionResult as S, type AnnotationAnchor as a, type AnnotationOccurrence as b, DocumentEngine as c, type DocumentMetrics as d, type DocumentOptions as e, type DocumentSnapshot as f, type HighlightData as g, type LineItem as h, type ParseContext as i, type SelectionSnapshot as j, type SourcePoint as k, type SourcePosition as l, type SourceRange as m, type SyntaxExtension as n, createDocument as o, knuthPlass as p, prepareKnuthPlass as q, replaceExtension as r, texBadness as t };