SPB Git

Repository Public

limitations.md 17.6 KB

# 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

# Other formats

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

# Platform and distribution

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
Files main
Menu

Theme