# Known limitations
One line per limitation, grouped by area. Each line links to the document that describes it in detail; nothing here adds a limitation that is not recorded there, in the code, or in the release record. This list applies to version 1.0.0 (build 2).
# Verification
What was not done or not verified, as opposed to what the software cannot do.
| Limitation |
Detail |
The XCUITest suite (UITests/EditorUITests.swift) was not run: macOS Automation Mode needs the owner's authentication. The in-app interaction self-test, which sends real NSEvents, was used instead; the two are not equivalent. |
testing.md |
| The self-test synthesises events in the process: it does not exercise the window server, an input method, dictation, VoiceOver or drag and drop from another application. |
testing.md |
| A skipped optional check (Poppler, pandoc, LibreOffice absent) counts as a passed test; the report does not record which optional checks ran. |
testing.md, pdf.md |
| Coverage (92.9 % of engine lines) excludes the application target and the command-line tools. |
coverage.json |
| Microsoft Word, Pages and Google Docs were never used to validate DOCX files. |
docx.md |
| No PDF/A or PDF/UA validator was run. |
pdf.md |
| The Shortcuts actions were compiled but never run from the Shortcuts app. |
automation.md |
| VoiceOver was not tested with a human listener. |
accessibility.md |
| The Intel (x86_64) slice is built but untested; no clean second Mac was used. |
distribution.md |
| Benchmarks are single runs of a synthetic document on one machine. |
performance.md |
# Editing
| Limitation |
Detail |
| Grammar checking, autocorrection and text replacement are not implemented. |
text-engine.md |
| Not provided by the custom text view: Writing Tools, inline predictions, Look Up and data detectors, Services for the selection, the system find bar, the Touch Bar, pinch-to-zoom. |
text-engine.md |
| Selected text cannot be dragged out or moved by dragging; RTF, HTML and native fragments are not read from a drop. |
text-engine.md |
| Bidirectional text: no split caret, logical-order arrow keys, approximate selection rectangles. |
text-engine.md |
| Dictation through the text input client is not exercised by any test. |
text-engine.md |
| Smart typography has no en-dash or ellipsis rule and is not applied to pasted or composed text. |
text-engine.md |
| A drag that starts with a double or triple click does not extend the selection. |
text-engine.md |
| Paragraphs of 20,000 UTF-16 units or more are not spell-checked. |
text-engine.md |
The launch option -ORIXPage has no effect when given on the command line. |
setup.md |
# Layout and pagination
| Limitation |
Detail |
| Line breaking is first-fit, not optimised per paragraph; hyphenation considers only the first word of the next line and one language per paragraph. |
layout-engine.md |
| Inline boxes (citation, cross-reference, field, note mark, inline image or equation) are unbreakable and can overflow the line. |
layout-engine.md |
| One leader style per paragraph; none on hyphenated lines. |
layout-engine.md |
| Small capitals and bold depend on the font; only italic is synthesised. |
layout-engine.md |
| Footnotes do not split between pages; a note taller than a column overflows. |
pagination.md |
| No column balancing; tables and floats do not span columns. |
pagination.md |
| A paragraph that continues in the next column after wrapping around an earlier paragraph's float keeps its narrowed lines. |
pagination.md |
| Keep with next looks at most five blocks ahead. |
pagination.md |
| Convergence of page references is bounded at four passes, not guaranteed. |
pagination.md |
| Every edit re-flows the whole body on the main thread; no incremental pagination, no background layout, no partial redraw after an edit. |
performance.md |
| Laying out documents from many threads at once can stall in the system font registry; tests run serially and batch jobs bound their concurrency (four files at a time by default). |
layout-engine.md |
| Several pagination rules have no test (space before and after, footnote reserve, float registration, lists of figures and tables). |
pagination.md |
| No unlimited page count is promised; measured sizes are 98 and 487 pages. |
performance.md |
# Tables
| Limitation |
Detail |
| Cells hold paragraphs only: no nested tables. Tables and breaks exist in the body only. |
text-engine.md |
| Rows do not split across pages; a row taller than a column overflows and is only reported. |
pagination.md |
| The rows of a vertical merge are not kept together across a page break. |
pagination.md |
| Tables ignore floats (they are not narrowed by an exclusion). |
pagination.md |
| A table wider than its column is scaled down and reported. |
layout-engine.md |
| Sorting refuses tables with vertical merges. |
text-engine.md |
# Images and objects
| Limitation |
Detail |
| No charts, SmartArt, grouped shapes, WordArt or picture effects; shapes are six presets with a one-line label. |
docx.md |
| Text boxes are not objects; on DOCX import their paragraphs are placed after the anchoring paragraph. |
docx.md |
| A PDF asset is drawn as its first page only. |
layout-engine.md |
| EMF and WMF pictures are kept as data and may not display. |
docx.md |
| Resizing an object is not a tracked change. |
text-engine.md |
# Mathematics
| Limitation |
Detail |
A subset of LaTeX math mode: no user macros, align, array, \underbrace, \overbrace, \overset, \underset, \boxed, \cancel, \phantom, \tag. |
technology-evaluation.md |
| Expressions over 4,000 characters, 24 nesting levels or 400 cells are refused and shown as source. |
security.md |
| LaTeX is normalised by a DOCX round trip; LaTeX the converter cannot parse is exported as text inside the equation. |
docx.md |
| In tagged PDF, equations are figures whose description is the LaTeX source, not formula elements. |
pdf.md |
| Text inside math is limited to west European and some Cyrillic characters (library limit). |
technology-evaluation.md |
# References
| Limitation |
Detail |
Six built-in citation styles; this is not a CSL processor and .csl files cannot be loaded. |
references.md |
| No note-based styles, no "ibid.". |
references.md |
| Titles are printed as stored (no case conversion); no journal, publisher or page-range abbreviation. |
references.md |
| Documented deviations from each style guide. |
references.md |
| In-text citations are plain text: no italics, no link to the entry. |
references.md |
| No DOI lookup, no reference-manager integration (no network). |
references.md |
| French localisation of citations covers connecting terms only. |
references.md |
BibTeX, RIS and CSL-JSON round-trip losses (@string macros, crossref, untagged RIS variables). |
references.md |
# Review
| Limitation |
Detail |
| Not tracked: table structure and cell clearing, inserted or deleted breaks and generated blocks, paragraph formatting, styles and lists, character-style and link changes, object resizing, section moves. |
text-engine.md |
Text committed by unmarkText() from an input method carries no insertion revision. |
text-engine.md |
| Comparison: differences in paragraph style, paragraph properties, lists, table properties and page setup are reported but cannot be rejected. |
review.md |
| Comparison: tables are never reported as moved; removed breaks and generated blocks are reported but not kept. |
review.md |
| Comment text is plain. |
docx.md |
| Real-time collaboration is intentionally absent. |
README |
# DOCX
| Limitation |
Detail |
| Perfect Word compatibility is not claimed; nothing was checked in Microsoft Word. |
docx.md |
| The corpus is small (19 documents, 526 words) and mostly synthetic. |
docx-compatibility.md |
| Layout (line breaks, pagination, fonts) is not compared by any test. |
docx-compatibility.md |
| No XML Schema validation of exported parts. |
docx.md |
Dropped with a warning: charts, SmartArt, embedded objects, linked pictures, macros, OLE, ActiveX, digital signatures, glossary, embedded fonts, altChunk. |
docx.md |
| Approximated with a warning: tracked moves, nested tables, text boxes, content controls, unknown fields, symbol characters, page breaks inside paragraphs. |
docx-compatibility.md |
| Tracked paragraph formatting and tracked table, section and numbering changes are not imported. |
docx.md |
settings.xml is rewritten: compatibility options, protection and mail merge are not kept. |
docx.md |
Identifiers are regenerated on import; DATE fields make two exports differ. |
docx.md |
| ZIP64 packages are refused. |
security.md |
| Limitation |
Detail |
| Markdown, HTML, RTF and plain text drop what they cannot carry (comments, headers and footers, sections, and more). |
formats.md |
| RTF goes through the system codec: no named styles, footnotes, comments, tracked changes, equations or headers and footers; RTFD is refused. |
formats.md |
| RTF written by Word, LibreOffice or Pages was not verified. |
formats.md |
| PDF import reads the text layer only, with paragraph heuristics verified on test-generated PDFs only; no OCR. |
formats.md |
| Native format: no encryption, no signature, no ZIP64, no incremental save. |
persistence.md |
| A recovered damaged native file stays bound to the damaged file; saving under a new name is advised, not enforced. |
persistence.md |
| Native files larger than a few megabytes were not verified. |
formats.md |
| Autosave: untitled never-saved documents, a kill during a write and power loss are not covered by the recovery test. |
persistence.md |
# PDF
| Limitation |
Detail |
| No PDF/A or PDF/UA conformance is claimed. |
pdf.md |
| Structure tags are partial: no table rows or cells, flat lists, untagged headers and footers, no artifacts, no document language. |
pdf.md |
| Reading order is drawing order. |
pdf.md |
| No colour management, no output intent, no CMYK; bleed is declared but not drawn. |
pdf.md |
| Comments are not exported; pending changes are published as accepted. |
pdf.md |
| Font embedding, subsetting, compression and PDF version are whatever Core Graphics produces. |
pdf.md |
| The structure-tag test only checks that a structure tree exists. |
pdf.md |
Note: the "PDF outline" entry under "Known limits" of automation.md describes an earlier implementation that attached the outline with PDFKit. The current publisher writes the outline through CGPDFContextSetOutline (pdf.md, test outlineMirrorsTheHeadings); the automation tests themselves still do not assert on the outline.
# On-device AI
| Limitation |
Detail |
| Requires macOS 26 or later with Apple Intelligence available and enabled; unavailable on macOS 15, the deployment target. |
technology-evaluation.md |
| Quality is not measured; output changes with operating-system updates and between machines. |
technology-evaluation.md |
| The context window is 4,096 to 8,192 tokens; long texts are processed part by part or by map-reduce, and detail is lost. |
technology-evaluation.md |
| The "concise tone" action often returns the text unchanged; the panel reports that no edit was proposed. |
README |
| The model can decline a request. |
technology-evaluation.md |
| Latency figures (1.7–8.5 s per action) are indicative, measured under machine load, and not stored in a report file. |
README |
| Rule-based tools depend on the language models installed with macOS. |
audit.md |
# Automation
| Limitation |
Detail |
| AppleScript is deferred: no scripting dictionary. |
automation.md |
| Shortcuts actions never run from Shortcuts; an intent launch would currently activate the app and show the template chooser. |
automation.md |
| Workflows have no conditions or loops, by design. |
automation.md |
| Two inputs with the same base name in one batch write to the same output name. |
automation.md |
| Automatic updates are not implemented (Sparkle was evaluated). |
technology-evaluation.md |
# Accessibility
| Limitation |
Detail |
| The review is by code inspection, not a certification. |
accessibility.md |
| The canvas exposes flat text: no headings, links, tracked changes, tables, images or equations as structure; a "line" is a paragraph. |
text-engine.md |
| Reduce Motion and Increase Contrast are not specifically handled; chrome text does not scale. |
design-system.md |
| Tertiary text and the light-appearance amber do not reach a 4.5:1 contrast ratio. |
accessibility.md |
| Limitation |
Detail |
| macOS 15.0 or later only. |
setup.md |
| Not sandboxed. |
security.md |
| Interface in English and Canadian French only; built-in style names are not translated. |
README |
| The dependency SwiftMath is pinned to an unreleased upstream revision. |
security.md |