@ai-matrx/print 0.8.3 → 0.8.5

package/dist/document.d.cts

@@ -21,7 +21,16 @@ interface MathSpan {
     tex: string;
     display: boolean;
 }
-/** Replace every math span with a private-use token; returns the spans. */
+/**
+ * Replace every math span with a private-use token; returns the spans.
+ *
+ * Print keeps NO fence, code-span or math detection of its own: the spans are
+ * the shared tokenizer's complete `math_block` / `math_inline` islands
+ * (`tokenizeSource` + `listIslands` from `@ai-matrx/content-ir/source` — the
+ * one fence-nesting rule and the one math pairing), so print, the renderer and
+ * the editor can never disagree about what is math. The delimiter decides the
+ * form: `$$`/`\[` display, `$`/`\(` inline.
+ */
 declare function extractMath(body: string): {
     text: string;
     spans: MathSpan[];
@@ -322,14 +331,22 @@ interface FallbackFontLoaders {
     emoji?: FontLoader | undefined;
     symbols?: FontLoader | undefined;
     cjk?: CjkFontLoader | undefined;
+    arabic?: FontLoader | undefined;
+    hebrew?: FontLoader | undefined;
 }
 /** Noto Sans JP (SIL OFL) from fontsource: 124 unicode-range subsets; only the needed ones load. */
 declare const NOTO_CJK_BASE = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-jp@5.3.0";
+/** Noto Sans KR (SIL OFL) — Hangul, same unicode-range scheme. */
+declare const NOTO_KR_BASE = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-kr@5.3.0";
+/** Noto Sans Arabic / Hebrew (SIL OFL) — one script subset each. */
+declare const NOTO_ARABIC_URL = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-arabic@5.3.0/files/noto-sans-arabic-arabic-400-normal.woff";
+declare const NOTO_HEBREW_URL = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-hebrew@5.3.0/files/noto-sans-hebrew-hebrew-400-normal.woff";
 /** Parse a fontsource stylesheet: each face's file stem and its unicode ranges. */
 declare function parseUnicodeRangeCss(css: string): Array<{
     file: string;
     ranges: Array<[number, number]>;
 }>;
+/** Hangul from Noto Sans KR, every other CJK character from Noto Sans JP. */
 declare const defaultCjkFontLoader: CjkFontLoader;
 /**
  * Words pdfmake did not put on a page: a text node with no position was never
@@ -416,6 +433,8 @@ declare class CitationEngine {
     /** A note style: every citation becomes a numbered note. */
     readonly isNote: boolean;
     private readonly numeric;
+    /** APA 7 §8.11: narrative citations join authors with "and", not "&". */
+    private readonly apaNarrativeAnd;
     constructor(styleXml: string, localeXml: string, items: CslItem[], lang: string);
     /** Cite a group; `noteIndex` is the note number for note styles (0 = in text). */
     cite(refs: CiteRef[], opts?: {
@@ -671,4 +690,4 @@ declare function exportDocument(source: string, format: DocumentFormat, options?
 /** Browser helper: save an export through a download link. */
 declare function downloadDocumentExport(exp: DocumentExport): void;
 
-export { BUNDLED_STYLE_IDS, type BibliographyEntry, type Block, CSL_STYLE_ALIASES, type Caption, CitationEngine, type CitationStyle, type CjkFontLoader, type CslFetcher, type CslItem, type CslName, DEFAULT_FOOTER, DOCUMENT_FORMATS, type DocSection, type DocTree, type DocumentExport, type DocumentFormat, type DocumentNotice, type DocumentSettings, type ExportDocumentOptions, type FallbackFontLoaders, type FontLoader, type ImageLoader, type ImageMap, type Inline, type ListItem, type Margins, type MathSpan, NOTO_CJK_BASE, NOTO_EMOJI_URL, NOTO_SYMBOLS_URL, type Orientation, PAGE_SIZES, type PageSizeName, type ParseDocumentOptions, type PrepareDocumentOptions, type ResolvedImage, type RunningTemplate, type TocEntry, type TypesetMath, buildPdfDefinition, countUnplacedWords, cslStyleId, defaultCjkFontLoader, defaultCslFetcher, defaultEmojiFontLoader, defaultImageLoader, defaultSymbolFontLoader, documentCss, documentToDocx, documentToEpub, documentToHtml, documentToPdf, downloadDocumentExport, exportDocument, extractMath, fillTemplate, loadCslLocale, loadCslStyle, mathKey, normalizeReference, parseCitationGroup, parseDocument, parseLength, parseLocator, parseMathML, parseUnicodeRangeCss, plainText, prepareDocument, renderBlocksHtml, renderPdfDefinition, resolveDocumentImages, resolveSettings, scanCitationKeys, splitFrontmatter, typesetDocumentMath };
+export { BUNDLED_STYLE_IDS, type BibliographyEntry, type Block, CSL_STYLE_ALIASES, type Caption, CitationEngine, type CitationStyle, type CjkFontLoader, type CslFetcher, type CslItem, type CslName, DEFAULT_FOOTER, DOCUMENT_FORMATS, type DocSection, type DocTree, type DocumentExport, type DocumentFormat, type DocumentNotice, type DocumentSettings, type ExportDocumentOptions, type FallbackFontLoaders, type FontLoader, type ImageLoader, type ImageMap, type Inline, type ListItem, type Margins, type MathSpan, NOTO_ARABIC_URL, NOTO_CJK_BASE, NOTO_EMOJI_URL, NOTO_HEBREW_URL, NOTO_KR_BASE, NOTO_SYMBOLS_URL, type Orientation, PAGE_SIZES, type PageSizeName, type ParseDocumentOptions, type PrepareDocumentOptions, type ResolvedImage, type RunningTemplate, type TocEntry, type TypesetMath, buildPdfDefinition, countUnplacedWords, cslStyleId, defaultCjkFontLoader, defaultCslFetcher, defaultEmojiFontLoader, defaultImageLoader, defaultSymbolFontLoader, documentCss, documentToDocx, documentToEpub, documentToHtml, documentToPdf, downloadDocumentExport, exportDocument, extractMath, fillTemplate, loadCslLocale, loadCslStyle, mathKey, normalizeReference, parseCitationGroup, parseDocument, parseLength, parseLocator, parseMathML, parseUnicodeRangeCss, plainText, prepareDocument, renderBlocksHtml, renderPdfDefinition, resolveDocumentImages, resolveSettings, scanCitationKeys, splitFrontmatter, typesetDocumentMath };

package/dist/document.d.ts

@@ -21,7 +21,16 @@ interface MathSpan {
     tex: string;
     display: boolean;
 }
-/** Replace every math span with a private-use token; returns the spans. */
+/**
+ * Replace every math span with a private-use token; returns the spans.
+ *
+ * Print keeps NO fence, code-span or math detection of its own: the spans are
+ * the shared tokenizer's complete `math_block` / `math_inline` islands
+ * (`tokenizeSource` + `listIslands` from `@ai-matrx/content-ir/source` — the
+ * one fence-nesting rule and the one math pairing), so print, the renderer and
+ * the editor can never disagree about what is math. The delimiter decides the
+ * form: `$$`/`\[` display, `$`/`\(` inline.
+ */
 declare function extractMath(body: string): {
     text: string;
     spans: MathSpan[];
@@ -322,14 +331,22 @@ interface FallbackFontLoaders {
     emoji?: FontLoader | undefined;
     symbols?: FontLoader | undefined;
     cjk?: CjkFontLoader | undefined;
+    arabic?: FontLoader | undefined;
+    hebrew?: FontLoader | undefined;
 }
 /** Noto Sans JP (SIL OFL) from fontsource: 124 unicode-range subsets; only the needed ones load. */
 declare const NOTO_CJK_BASE = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-jp@5.3.0";
+/** Noto Sans KR (SIL OFL) — Hangul, same unicode-range scheme. */
+declare const NOTO_KR_BASE = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-kr@5.3.0";
+/** Noto Sans Arabic / Hebrew (SIL OFL) — one script subset each. */
+declare const NOTO_ARABIC_URL = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-arabic@5.3.0/files/noto-sans-arabic-arabic-400-normal.woff";
+declare const NOTO_HEBREW_URL = "https://cdn.jsdelivr.net/npm/@fontsource/noto-sans-hebrew@5.3.0/files/noto-sans-hebrew-hebrew-400-normal.woff";
 /** Parse a fontsource stylesheet: each face's file stem and its unicode ranges. */
 declare function parseUnicodeRangeCss(css: string): Array<{
     file: string;
     ranges: Array<[number, number]>;
 }>;
+/** Hangul from Noto Sans KR, every other CJK character from Noto Sans JP. */
 declare const defaultCjkFontLoader: CjkFontLoader;
 /**
  * Words pdfmake did not put on a page: a text node with no position was never
@@ -416,6 +433,8 @@ declare class CitationEngine {
     /** A note style: every citation becomes a numbered note. */
     readonly isNote: boolean;
     private readonly numeric;
+    /** APA 7 §8.11: narrative citations join authors with "and", not "&". */
+    private readonly apaNarrativeAnd;
     constructor(styleXml: string, localeXml: string, items: CslItem[], lang: string);
     /** Cite a group; `noteIndex` is the note number for note styles (0 = in text). */
     cite(refs: CiteRef[], opts?: {
@@ -671,4 +690,4 @@ declare function exportDocument(source: string, format: DocumentFormat, options?
 /** Browser helper: save an export through a download link. */
 declare function downloadDocumentExport(exp: DocumentExport): void;
 
-export { BUNDLED_STYLE_IDS, type BibliographyEntry, type Block, CSL_STYLE_ALIASES, type Caption, CitationEngine, type CitationStyle, type CjkFontLoader, type CslFetcher, type CslItem, type CslName, DEFAULT_FOOTER, DOCUMENT_FORMATS, type DocSection, type DocTree, type DocumentExport, type DocumentFormat, type DocumentNotice, type DocumentSettings, type ExportDocumentOptions, type FallbackFontLoaders, type FontLoader, type ImageLoader, type ImageMap, type Inline, type ListItem, type Margins, type MathSpan, NOTO_CJK_BASE, NOTO_EMOJI_URL, NOTO_SYMBOLS_URL, type Orientation, PAGE_SIZES, type PageSizeName, type ParseDocumentOptions, type PrepareDocumentOptions, type ResolvedImage, type RunningTemplate, type TocEntry, type TypesetMath, buildPdfDefinition, countUnplacedWords, cslStyleId, defaultCjkFontLoader, defaultCslFetcher, defaultEmojiFontLoader, defaultImageLoader, defaultSymbolFontLoader, documentCss, documentToDocx, documentToEpub, documentToHtml, documentToPdf, downloadDocumentExport, exportDocument, extractMath, fillTemplate, loadCslLocale, loadCslStyle, mathKey, normalizeReference, parseCitationGroup, parseDocument, parseLength, parseLocator, parseMathML, parseUnicodeRangeCss, plainText, prepareDocument, renderBlocksHtml, renderPdfDefinition, resolveDocumentImages, resolveSettings, scanCitationKeys, splitFrontmatter, typesetDocumentMath };
+export { BUNDLED_STYLE_IDS, type BibliographyEntry, type Block, CSL_STYLE_ALIASES, type Caption, CitationEngine, type CitationStyle, type CjkFontLoader, type CslFetcher, type CslItem, type CslName, DEFAULT_FOOTER, DOCUMENT_FORMATS, type DocSection, type DocTree, type DocumentExport, type DocumentFormat, type DocumentNotice, type DocumentSettings, type ExportDocumentOptions, type FallbackFontLoaders, type FontLoader, type ImageLoader, type ImageMap, type Inline, type ListItem, type Margins, type MathSpan, NOTO_ARABIC_URL, NOTO_CJK_BASE, NOTO_EMOJI_URL, NOTO_HEBREW_URL, NOTO_KR_BASE, NOTO_SYMBOLS_URL, type Orientation, PAGE_SIZES, type PageSizeName, type ParseDocumentOptions, type PrepareDocumentOptions, type ResolvedImage, type RunningTemplate, type TocEntry, type TypesetMath, buildPdfDefinition, countUnplacedWords, cslStyleId, defaultCjkFontLoader, defaultCslFetcher, defaultEmojiFontLoader, defaultImageLoader, defaultSymbolFontLoader, documentCss, documentToDocx, documentToEpub, documentToHtml, documentToPdf, downloadDocumentExport, exportDocument, extractMath, fillTemplate, loadCslLocale, loadCslStyle, mathKey, normalizeReference, parseCitationGroup, parseDocument, parseLength, parseLocator, parseMathML, parseUnicodeRangeCss, plainText, prepareDocument, renderBlocksHtml, renderPdfDefinition, resolveDocumentImages, resolveSettings, scanCitationKeys, splitFrontmatter, typesetDocumentMath };