@fiduswriter/document 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/exporter/tools/xml_zip.js

@@ -0,0 +1,86 @@
+import { xmlDOM } from "./xml.js";
+import { get } from "fwtoolkit";
+// Handle a zip file containing XML files. Make sure files are only opened once,
+// and provide a mechanism to save the file.
+export class XmlZip {
+    constructor(url, mimeType) {
+        this.url = url;
+        this.mimeType = mimeType;
+        this.docs = {};
+        this.extraFiles = {};
+        this.rawFile = false;
+    }
+    init() {
+        return import("jszip")
+            .then(({ default: JSZip }) => {
+            this.zip = new JSZip();
+            return this.downloadZip();
+        })
+            .then(() => this.loadZip());
+    }
+    downloadZip() {
+        return get(this.url)
+            .then(response => response.blob())
+            .then(blob => (this.rawFile = blob));
+    }
+    loadZip() {
+        return this.zip.loadAsync(this.rawFile);
+    }
+    // Open file at filePath from zip file and parse it as XML.
+    getXml(filePath, defaultContents) {
+        if (this.docs[filePath]) {
+            // file has been loaded already.
+            return Promise.resolve(this.docs[filePath]);
+        }
+        else if (this.zip.files[filePath]) {
+            return this.zip
+                .file(filePath)
+                .async("string")
+                .then(string => {
+                this.docs[filePath] = xmlDOM(string);
+                return Promise.resolve(this.docs[filePath]);
+            });
+        }
+        else if (defaultContents) {
+            return Promise.resolve(defaultContents).then(string => {
+                this.docs[filePath] = xmlDOM(string);
+                return Promise.resolve(this.docs[filePath]);
+            });
+        }
+        else {
+            // File couldn't be found and there was no default value.
+            return Promise.reject(new Error("File not found"));
+        }
+    }
+    // Add an xml file at filepath without checking for previous version
+    addXmlFile(filePath, xmlContents) {
+        this.docs[filePath] = xmlContents;
+    }
+    // Add extra file to be saved in zip later.
+    addExtraFile(filePath, fileContents) {
+        this.extraFiles[filePath] = fileContents;
+    }
+    // Put all currently open XML files into zip.
+    allXMLToZip() {
+        for (const fileName in this.docs) {
+            this.xmlToZip(fileName);
+        }
+    }
+    // Put all extra files into zip.
+    allExtraToZip() {
+        for (const fileName in this.extraFiles) {
+            this.zip.file(fileName, this.extraFiles[fileName]);
+        }
+    }
+    // Put the xml identified by filePath into zip.
+    xmlToZip(filePath) {
+        const string = this.docs[filePath].toString();
+        this.zip.file(filePath, string);
+    }
+    prepareBlob() {
+        this.allXMLToZip();
+        this.allExtraToZip();
+        return this.zip.generateAsync({ type: "blob", mimeType: this.mimeType });
+    }
+}
+//# sourceMappingURL=xml_zip.js.map

package/dist/exporter/tools/xml_zip.js.map

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

package/dist/exporter/tools/zip.d.ts

@@ -0,0 +1,21 @@
+/** Creates a zip file.
+ * @function zipFileCreator
+ * @param {list} textFiles A list of files in plain text format.
+ * @param {list} binaryFiles A list fo files that have to be downloaded from the internet before being included.
+ * @param {list} includeZips A list of zip files to be merged into the output zip file.
+ * @param {string} [mimeType=application/zip] The mimetype of the file that is to be created.
+ */
+export class ZipFileCreator {
+    constructor(textFiles?: any[], binaryFiles?: any[], zipFiles?: any[], mimeType?: string, date?: Date);
+    textFiles: any[];
+    binaryFiles: any[];
+    zipFiles: any[];
+    mimeType: string;
+    date: Date;
+    init(): Promise<Blob>;
+    zipFs: import("jszip") | undefined;
+    includeZips(): Promise<Blob>;
+    createZip(): Promise<Blob>;
+    convertDataURIToBlob(dataURI: any): Blob;
+}
+//# sourceMappingURL=zip.d.ts.map

package/dist/exporter/tools/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../../src/exporter/tools/zip.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH;IACI,sGAYC;IALG,iBAA0B;IAC1B,mBAA8B;IAC9B,gBAAwB;IACxB,iBAAwB;IACxB,WAAgB;IAGpB,sBAYC;IATO,mCAAwB;IAWhC,6BAiBC;IAED,2BAyBC;IAGD,yCAEC;CACJ"}

package/dist/exporter/tools/zip.js

@@ -0,0 +1,71 @@
+import { convertDataURIToBlob, get } from "fwtoolkit";
+/** Creates a zip file.
+ * @function zipFileCreator
+ * @param {list} textFiles A list of files in plain text format.
+ * @param {list} binaryFiles A list fo files that have to be downloaded from the internet before being included.
+ * @param {list} includeZips A list of zip files to be merged into the output zip file.
+ * @param {string} [mimeType=application/zip] The mimetype of the file that is to be created.
+ */
+export class ZipFileCreator {
+    constructor(textFiles = [], binaryFiles = [], zipFiles = [], mimeType = "application/zip", date = new Date()) {
+        this.textFiles = textFiles;
+        this.binaryFiles = binaryFiles;
+        this.zipFiles = zipFiles;
+        this.mimeType = mimeType;
+        this.date = date;
+    }
+    init() {
+        return import("jszip").then(({ default: JSZip }) => {
+            JSZip.defaults.date = this.date;
+            this.zipFs = new JSZip();
+            if (this.mimeType !== "application/zip") {
+                this.zipFs.file("mimetype", this.mimeType, {
+                    compression: "STORE"
+                });
+            }
+            return this.includeZips();
+        });
+    }
+    includeZips() {
+        const getZipBlobs = this.zipFiles.map(zipFile => {
+            return get(zipFile.url)
+                .then(response => response.blob())
+                .then(blob => (zipFile.blob = blob));
+        });
+        return Promise.all(getZipBlobs)
+            .then(() => {
+            return this.zipFiles.map(zipFile => {
+                const zipDir = zipFile.directory === ""
+                    ? this.zipFs
+                    : this.zipFs.folder(zipFile.directory);
+                return zipDir.loadAsync(zipFile.blob);
+            });
+        })
+            .then(() => this.createZip());
+    }
+    createZip() {
+        this.textFiles.forEach(textFile => {
+            this.zipFs.file(textFile.filename, textFile.contents, {
+                compression: "DEFLATE"
+            });
+        });
+        const blobPromises = this.binaryFiles.map(binaryFile => get(binaryFile.url)
+            .then(response => response.blob())
+            .then(blob => Promise.resolve({ blob, filename: binaryFile.filename })));
+        return Promise.all(blobPromises).then(promises => {
+            promises.forEach(promise => this.zipFs.file(promise.filename, promise.blob, {
+                binary: true,
+                compression: "DEFLATE"
+            }));
+            return this.zipFs.generateAsync({
+                type: "blob",
+                mimeType: this.mimeType
+            });
+        });
+    }
+    // Legacy - remove in 3.12. Can be sued directly from function in common/blob.js
+    convertDataURIToBlob(dataURI) {
+        return convertDataURIToBlob(dataURI);
+    }
+}
+//# sourceMappingURL=zip.js.map

package/dist/exporter/tools/zip.js.map

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

package/dist/exporter/tools/zotero_csl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Create a Zotero citation JSON object.
+ * @param {Array} references - Array of {id, prefix?, locator?} from citation node
+ * @param {Object} bibDB - Bibliography database
+ * @param {string} formattedCitation - Pre-formatted citation text from citeproc
+ * @param {string} citationId - Optional citation ID (generated if not provided)
+ * @returns {Object} Zotero citation JSON object
+ */
+export function createZoteroCitation(references: any[], bibDB: Object, formattedCitation: string, citationId?: string): Object;
+//# sourceMappingURL=zotero_csl.d.ts.map

package/dist/exporter/tools/zotero_csl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zotero_csl.d.ts","sourceRoot":"","sources":["../../../src/exporter/tools/zotero_csl.js"],"names":[],"mappings":"AAgCA;;;;;;;GAOG;AACH,+DALW,MAAM,qBACN,MAAM,eACN,MAAM,GACJ,MAAM,CAsDlB"}

package/dist/exporter/tools/zotero_csl.js

@@ -0,0 +1,78 @@
+/**
+ * Helper functions for creating Zotero-compatible citation data.
+ * Uses CSLExporter from biblatex-csl-converter to convert Fidus Writer's
+ * internal BibLaTeX format to CSL-JSON.
+ */
+import { CSLExporter } from "biblatex-csl-converter";
+/**
+ * Generate a random citation ID similar to Zotero's format.
+ * Zotero uses 8-10 character alphanumeric IDs.
+ */
+function generateCitationId() {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let id = "";
+    for (let i = 0; i < 8; i++) {
+        id += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return id;
+}
+/**
+ * Convert bibliography entries to CSL-JSON format.
+ * @param {Object} bibDB - The bibliography database
+ * @param {Array} ids - Array of entry IDs to convert
+ * @returns {Object} Object mapping IDs to CSL-JSON entries
+ */
+function convertToCSL(bibDB, ids) {
+    const exporter = new CSLExporter(bibDB.db, ids);
+    return exporter.parse();
+}
+/**
+ * Create a Zotero citation JSON object.
+ * @param {Array} references - Array of {id, prefix?, locator?} from citation node
+ * @param {Object} bibDB - Bibliography database
+ * @param {string} formattedCitation - Pre-formatted citation text from citeproc
+ * @param {string} citationId - Optional citation ID (generated if not provided)
+ * @returns {Object} Zotero citation JSON object
+ */
+export function createZoteroCitation(references, bibDB, formattedCitation, citationId = null) {
+    const citationID = citationId || generateCitationId();
+    // Get the IDs of all referenced items
+    const ids = references.map(ref => ref.id);
+    // Convert to CSL-JSON
+    const _cslData = convertToCSL(bibDB, ids);
+    const citationItems = references
+        .map(ref => {
+        const entry = bibDB.db[ref.id];
+        if (!entry) {
+            return null;
+        }
+        const citationKey = entry.entry_key || String(ref.id);
+        const item = {
+            id: ref.id,
+            uris: [],
+            itemData: {
+                ...ref.item,
+                id: citationKey
+            }
+        };
+        if (ref.locator) {
+            item.locator = ref.locator;
+        }
+        if (ref.prefix) {
+            item.prefix = ref.prefix;
+        }
+        return item;
+    })
+        .filter(item => item !== null);
+    return {
+        citationID,
+        properties: {
+            formattedCitation,
+            plainCitation: formattedCitation,
+            noteIndex: 0
+        },
+        citationItems,
+        schema: "https://github.com/citation-style-language/schema/raw/master/csl-citation.json"
+    };
+}
+//# sourceMappingURL=zotero_csl.js.map

package/dist/exporter/tools/zotero_csl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zotero_csl.js","sourceRoot":"","sources":["../../../src/exporter/tools/zotero_csl.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAA;AAElD;;;GAGG;AACH,SAAS,kBAAkB;IACvB,MAAM,KAAK,GAAG,sCAAsC,CAAA;IACpD,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,EAAE,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAK,EAAE,GAAG;IAC5B,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC/C,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAChC,UAAU,EACV,KAAK,EACL,iBAAiB,EACjB,UAAU,GAAG,IAAI;IAEjB,MAAM,UAAU,GAAG,UAAU,IAAI,kBAAkB,EAAE,CAAA;IAErD,sCAAsC;IACtC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEzC,sBAAsB;IACtB,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACzC,MAAM,aAAa,GAAG,UAAU;SAC3B,GAAG,CAAC,GAAG,CAAC,EAAE;QACP,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAA;QACf,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrD,MAAM,IAAI,GAAG;YACT,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE;gBACN,GAAG,GAAG,CAAC,IAAI;gBACX,EAAE,EAAE,WAAW;aAClB;SACJ,CAAA;QAED,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;QAC9B,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;QAC5B,CAAC;QAED,OAAO,IAAI,CAAA;IACf,CAAC,CAAC;SACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAElC,OAAO;QACH,UAAU;QACV,UAAU,EAAE;YACR,iBAAiB;YACjB,aAAa,EAAE,iBAAiB;YAChC,SAAS,EAAE,CAAC;SACf;QACD,aAAa;QACb,MAAM,EAAE,gFAAgF;KAC3F,CAAA;AACL,CAAC"}

package/dist/importer/citations.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Convert a CitationResult from a static DocxCitationsParser or
+ * OdtCitationsParser call into a Fidus Writer citation node.
+ *
+ * The `bibliography` object is mutated in place to include any new entries.
+ *
+ * Each item in `metadata` (when `retrieveMetadata` was true) may carry:
+ *   - id         : entry_key string identifying which entry this item refers to
+ *   - prefix     : citation prefix text
+ *   - suffix     : citation suffix / locator text (used as `locator`)
+ *   - locator    : explicit locator string (preferred over suffix when present)
+ *   - authorOnly : boolean – render author name only (maps to "textcite")
+ *   - suppressAuthor : boolean – suppress author name (ignored, maps to default)
+ *   - authorYear : boolean – render author name and year (maps to "textcite")
+ *
+ * `format` on the returned citation node matches the Fidus Writer citation schema:
+ *   - "textcite"  when authorOnly or authorYear is set on the (single) item (biblatex \textcite)
+ *   - "autocite"  otherwise, including when suppressAuthor is set (biblatex \autocite)
+ *
+ * @param {Object} result       CitationResult from a static parser method
+ * @param {Object} bibliography Fidus Writer bibliography (mutated in place)
+ * @returns {Object|null}  ProseMirror citation node or null
+ */
+export function citationResultToNode(result: Object, bibliography: Object, bibDB?: boolean): Object | null;
+//# sourceMappingURL=citations.d.ts.map

package/dist/importer/citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.d.ts","sourceRoot":"","sources":["../../src/importer/citations.js"],"names":[],"mappings":"AA0DA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,6CAJW,MAAM,gBACN,MAAM,oBACJ,MAAM,GAAC,IAAI,CAiDvB"}

package/dist/importer/citations.js

@@ -0,0 +1,116 @@
+/**
+ * Shared citation utilities for DOCX and ODT importers.
+ *
+ * Converts a CitationResult (from DocxCitationsParser or OdtCitationsParser
+ * static methods) plus a BibDB (entries) into a Fidus Writer citation node,
+ * and merges the new BibDB entries into the document bibliography.
+ *
+ * The `bibliography` object passed in is mutated in place: new entries are
+ * appended with sequential numeric string keys ("1", "2", …).
+ */
+/**
+ * Given a BibDB returned by a static Citations parser call and the current
+ * document bibliography, add every entry that is not yet present (matched by
+ * entry_key) and return a mapping from entry_key → bibliography key string.
+ *
+ * @param {Object} entries  BibDB (Record<number, EntryObject>) from parser
+ * @param {Object} bibliography  Fidus Writer bibliography (mutated in place)
+ * @returns {Object}  Map of entry_key → bibKey string
+ */
+function mergeBibEntries(entries, bibliography, bibDB) {
+    const keyMap = {};
+    for (const entry of Object.values(entries)) {
+        if (!entry || !entry.entry_key) {
+            continue;
+        }
+        const entryKey = entry.entry_key;
+        // Check whether this entry_key is already in the bibliography.
+        const existing = Object.entries(bibliography).find(([, bibEntry]) => bibEntry && bibEntry.entry_key === entryKey);
+        if (existing) {
+            keyMap[entryKey] = existing[0];
+        }
+        else {
+            if (bibDB && Object.keys(entry.fields).length === 0) {
+                // Jabref citations don't contain any fields. Look up values in bibDB instead
+                const bibEntry = Object.values(bibDB.db).find(bibEntry => bibEntry && bibEntry.entry_key === entryKey);
+                if (bibEntry) {
+                    entry.fields = JSON.parse(JSON.stringify(bibEntry.fields));
+                    entry.bib_type = bibEntry.bib_type;
+                }
+            }
+            // TODO: add for jabref citations - according to entry_key import from user
+            // library if useExternalDB is true
+            const bibKey = String(Object.keys(bibliography).length + 1);
+            bibliography[bibKey] = entry;
+            keyMap[entryKey] = bibKey;
+        }
+    }
+    return keyMap;
+}
+/**
+ * Convert a CitationResult from a static DocxCitationsParser or
+ * OdtCitationsParser call into a Fidus Writer citation node.
+ *
+ * The `bibliography` object is mutated in place to include any new entries.
+ *
+ * Each item in `metadata` (when `retrieveMetadata` was true) may carry:
+ *   - id         : entry_key string identifying which entry this item refers to
+ *   - prefix     : citation prefix text
+ *   - suffix     : citation suffix / locator text (used as `locator`)
+ *   - locator    : explicit locator string (preferred over suffix when present)
+ *   - authorOnly : boolean – render author name only (maps to "textcite")
+ *   - suppressAuthor : boolean – suppress author name (ignored, maps to default)
+ *   - authorYear : boolean – render author name and year (maps to "textcite")
+ *
+ * `format` on the returned citation node matches the Fidus Writer citation schema:
+ *   - "textcite"  when authorOnly or authorYear is set on the (single) item (biblatex \textcite)
+ *   - "autocite"  otherwise, including when suppressAuthor is set (biblatex \autocite)
+ *
+ * @param {Object} result       CitationResult from a static parser method
+ * @param {Object} bibliography Fidus Writer bibliography (mutated in place)
+ * @returns {Object|null}  ProseMirror citation node or null
+ */
+export function citationResultToNode(result, bibliography, bibDB = false) {
+    if (!result || !result.isCitation || !result.entries) {
+        return null;
+    }
+    const entries = result.entries;
+    const metadata = result.metadata || [];
+    if (Object.keys(entries).length === 0) {
+        return null;
+    }
+    const keyMap = mergeBibEntries(entries, bibliography, bibDB);
+    // Build the references array from entries.
+    //
+    const references = Object.entries(entries).map(([_entryId, entry]) => {
+        const entryKey = entry.entry_key;
+        const entryMetadata = metadata.find(meta => meta.entry_key === entryKey);
+        return {
+            id: keyMap[entryKey],
+            prefix: entryMetadata?.prefix || "",
+            locator: entryMetadata?.locator || entryMetadata?.suffix || ""
+        };
+    });
+    if (references.length === 0) {
+        return null;
+    }
+    // Determine citation format from the first item's metadata flags.
+    // "textcite" corresponds to biblatex's \textcite (author-in-text / authorYear).
+    // Even authorOnly comes through as "textcite" since it's a similar concept.
+    // Everything else, including suppressAuthor, falls back to "autocite".
+    // TODO: When an authorOnly citation is followed directly by a suppressAuthor
+    // citation, this would display the same as a single authorYear citation and
+    // should be treated as such.
+    const format = metadata.length === 1 &&
+        (metadata[0].authorOnly || metadata[0].authorYear)
+        ? "textcite"
+        : "autocite";
+    return {
+        type: "citation",
+        attrs: {
+            format,
+            references
+        }
+    };
+}
+//# sourceMappingURL=citations.js.map

package/dist/importer/citations.js.map

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

package/dist/importer/docx/citations.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Check whether a field instruction string belongs to a citation.
+ * Uses DocxCitationsParser.fieldCitation() with retrieve=false so no BibDB
+ * is allocated for the check.
+ *
+ * @param {string} instrText - Concatenated w:instrText content
+ * @returns {boolean}
+ */
+export function isDocxCitationField(instrText: string): boolean;
+/**
+ * Check whether a field instruction string belongs to a bibliography region
+ * (Zotero ZOTERO_BIBL, Word native BIBLIOGRAPHY, EN.REFLIST, etc.).
+ * Uses DocxCitationsParser.fieldBibliography() with the accumulated
+ * instruction text between begin and separate markers.
+ *
+ * @param {string} instrText - Concatenated w:instrText content
+ * @returns {boolean}
+ */
+export function isDocxBibliographyField(instrText: string): boolean;
+/**
+ * Check whether a w:sdt node contains a citation (Mendeley v3, Citavi).
+ * Uses DocxCitationsParser.sdtCitation() with retrieve=false.
+ *
+ * @param {Object} sdtNode - The parsed w:sdt XMLElement node
+ * @returns {boolean}
+ */
+export function isDocxSdtCitation(sdtNode: Object): boolean;
+/**
+ * Check whether a w:sdt node is a bibliography rendering region
+ * (Mendeley v3 bibliography, Citavi bibliography).
+ * Uses DocxCitationsParser.sdtBibliography().
+ *
+ * @param {Object} sdtNode - The parsed w:sdt XMLElement node
+ * @returns {boolean}
+ */
+export function isDocxSdtBibliography(sdtNode: Object): boolean;
+/**
+ * Parse a citation from a DOCX field instruction and add any new bibliography
+ * entries into `bibliography`.
+ *
+ * Handles all field-based citation managers: Zotero, Mendeley Desktop
+ * (legacy), EndNote (both inline and fldData forms), Citavi (older ADDIN
+ * form), and Word native (requires sourcesXml).
+ *
+ * @param {string}      instrText    - Concatenated w:instrText for this field
+ * @param {string|null} fldData      - Base64 content of w:fldData (EndNote),
+ *                                     or null/undefined if absent
+ * @param {string|null} sourcesXml   - Content of customXml/item1.xml (required
+ *                                     only for Word-native citations)
+ * @param {Object}      bibliography - Fidus Writer bibliography (mutated)
+ * @returns {Object|null}  ProseMirror citation node or null
+ */
+export function parseDocxFieldCitation(instrText: string, fldData: string | null, sourcesXml: string | null, bibliography: Object): Object | null;
+/**
+ * Parse a citation from a DOCX structured document tag (w:sdt) and add any
+ * new bibliography entries into `bibliography`.
+ *
+ * Handles Mendeley Cite v3 and Citavi (modern SDT form).
+ *
+ * @param {Object} sdtNode      - The parsed w:sdt XMLElement node
+ * @param {Object} bibliography - Fidus Writer bibliography (mutated)
+ * @returns {Object|null}  ProseMirror citation node or null
+ */
+export function parseDocxSdtCitation(sdtNode: Object, bibliography: Object): Object | null;
+//# sourceMappingURL=citations.d.ts.map

package/dist/importer/docx/citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.d.ts","sourceRoot":"","sources":["../../../src/importer/docx/citations.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,+CAHW,MAAM,GACJ,OAAO,CAOnB;AAED;;;;;;;;GAQG;AACH,mDAHW,MAAM,GACJ,OAAO,CAQnB;AAED;;;;;;GAMG;AACH,2CAHW,MAAM,GACJ,OAAO,CAOnB;AAED;;;;;;;GAOG;AACH,+CAHW,MAAM,GACJ,OAAO,CAOnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,kDARW,MAAM,WACN,MAAM,GAAC,IAAI,cAEX,MAAM,GAAC,IAAI,gBAEX,MAAM,GACJ,MAAM,GAAC,IAAI,CAsBvB;AAED;;;;;;;;;GASG;AACH,8CAJW,MAAM,gBACN,MAAM,GACJ,MAAM,GAAC,IAAI,CAYvB"}

package/dist/importer/docx/citations.js

@@ -0,0 +1,106 @@
+import { DocxCitationsParser } from "biblatex-csl-converter";
+import { citationResultToNode } from "../citations.js";
+/**
+ * Check whether a field instruction string belongs to a citation.
+ * Uses DocxCitationsParser.fieldCitation() with retrieve=false so no BibDB
+ * is allocated for the check.
+ *
+ * @param {string} instrText - Concatenated w:instrText content
+ * @returns {boolean}
+ */
+export function isDocxCitationField(instrText) {
+    if (!instrText) {
+        return false;
+    }
+    return DocxCitationsParser.fieldCitation(instrText, false).isCitation;
+}
+/**
+ * Check whether a field instruction string belongs to a bibliography region
+ * (Zotero ZOTERO_BIBL, Word native BIBLIOGRAPHY, EN.REFLIST, etc.).
+ * Uses DocxCitationsParser.fieldBibliography() with the accumulated
+ * instruction text between begin and separate markers.
+ *
+ * @param {string} instrText - Concatenated w:instrText content
+ * @returns {boolean}
+ */
+export function isDocxBibliographyField(instrText) {
+    if (!instrText) {
+        return false;
+    }
+    return DocxCitationsParser.fieldBibliography(instrText).isBibliography;
+}
+/**
+ * Check whether a w:sdt node contains a citation (Mendeley v3, Citavi).
+ * Uses DocxCitationsParser.sdtCitation() with retrieve=false.
+ *
+ * @param {Object} sdtNode - The parsed w:sdt XMLElement node
+ * @returns {boolean}
+ */
+export function isDocxSdtCitation(sdtNode) {
+    if (!sdtNode) {
+        return false;
+    }
+    return DocxCitationsParser.sdtCitation(sdtNode.outerXML, false).isCitation;
+}
+/**
+ * Check whether a w:sdt node is a bibliography rendering region
+ * (Mendeley v3 bibliography, Citavi bibliography).
+ * Uses DocxCitationsParser.sdtBibliography().
+ *
+ * @param {Object} sdtNode - The parsed w:sdt XMLElement node
+ * @returns {boolean}
+ */
+export function isDocxSdtBibliography(sdtNode) {
+    if (!sdtNode) {
+        return false;
+    }
+    return DocxCitationsParser.sdtBibliography(sdtNode.outerXML).isBibliography;
+}
+/**
+ * Parse a citation from a DOCX field instruction and add any new bibliography
+ * entries into `bibliography`.
+ *
+ * Handles all field-based citation managers: Zotero, Mendeley Desktop
+ * (legacy), EndNote (both inline and fldData forms), Citavi (older ADDIN
+ * form), and Word native (requires sourcesXml).
+ *
+ * @param {string}      instrText    - Concatenated w:instrText for this field
+ * @param {string|null} fldData      - Base64 content of w:fldData (EndNote),
+ *                                     or null/undefined if absent
+ * @param {string|null} sourcesXml   - Content of customXml/item1.xml (required
+ *                                     only for Word-native citations)
+ * @param {Object}      bibliography - Fidus Writer bibliography (mutated)
+ * @returns {Object|null}  ProseMirror citation node or null
+ */
+export function parseDocxFieldCitation(instrText, fldData, sourcesXml, bibliography) {
+    if (!instrText) {
+        return null;
+    }
+    const options = sourcesXml ? { sourcesXml } : {};
+    const result = DocxCitationsParser.fieldCitation(instrText, true, // retrieve
+    true, // retrieveMetadata
+    true, // extractWordNative
+    fldData || undefined, options);
+    const node = citationResultToNode(result, bibliography);
+    return node;
+}
+/**
+ * Parse a citation from a DOCX structured document tag (w:sdt) and add any
+ * new bibliography entries into `bibliography`.
+ *
+ * Handles Mendeley Cite v3 and Citavi (modern SDT form).
+ *
+ * @param {Object} sdtNode      - The parsed w:sdt XMLElement node
+ * @param {Object} bibliography - Fidus Writer bibliography (mutated)
+ * @returns {Object|null}  ProseMirror citation node or null
+ */
+export function parseDocxSdtCitation(sdtNode, bibliography) {
+    if (!sdtNode) {
+        return null;
+    }
+    const result = DocxCitationsParser.sdtCitation(sdtNode.outerXML, true, // retrieve
+    true // retrieveMetadata
+    );
+    return citationResultToNode(result, bibliography);
+}
+//# sourceMappingURL=citations.js.map

package/dist/importer/docx/citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.js","sourceRoot":"","sources":["../../../src/importer/docx/citations.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAC,oBAAoB,EAAC,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAS;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,OAAO,mBAAmB,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,UAAU,CAAA;AACzE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAS;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAA;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAO;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,OAAO,mBAAmB,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,UAAU,CAAA;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAO;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,OAAO,mBAAmB,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAA;AAC/E,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAClC,SAAS,EACT,OAAO,EACP,UAAU,EACV,YAAY;IAEZ,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,IAAI,CAAA;IACf,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,EAAC,UAAU,EAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9C,MAAM,MAAM,GAAG,mBAAmB,CAAC,aAAa,CAC5C,SAAS,EACT,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,IAAI,SAAS,EACpB,OAAO,CACV,CAAA;IACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACvD,OAAO,IAAI,CAAA;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAO,EAAE,YAAY;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,IAAI,CAAA;IACf,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAC1C,OAAO,CAAC,QAAQ,EAChB,IAAI,EAAE,WAAW;IACjB,IAAI,CAAC,mBAAmB;KAC3B,CAAA;IACD,OAAO,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AACrD,CAAC"}