SPB Git

Repository Public

limitations.md 17.6 KB 197 lines markdown

1<!--2ORIX Docs3File: docs/compatibility/limitations.md4Description: Consolidated list of the known limitations of ORIX Docs 1.0.0, grouped by area, each with a link to the document that details it.5Author: Simon-Pierre Boucher6Contact: contact@spboucher.ai7-->8# Known limitations910One 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).1112## Verification1314What was not done or not verified, as opposed to what the software cannot do.1516| Limitation | Detail |17|---|---|18| 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 `NSEvent`s, was used instead; the two are not equivalent. | [testing.md](../development/testing.md#xcuitest-suite) |19| 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](../development/testing.md#interaction-self-test) |20| A skipped optional check (Poppler, pandoc, LibreOffice absent) counts as a passed test; the report does not record which optional checks ran. | [testing.md](../development/testing.md#engine-tests), [pdf.md](../architecture/pdf.md#what-is-written) |21| Coverage (92.9 % of engine lines) excludes the application target and the command-line tools. | [coverage.json](../reports/coverage.json) |22| Microsoft Word, Pages and Google Docs were never used to validate DOCX files. | [docx.md](docx.md#how-this-was-validated--and-how-it-was-not) |23| No PDF/A or PDF/UA validator was run. | [pdf.md](../architecture/pdf.md#what-is-not-claimed) |24| The Shortcuts actions were compiled but never run from the Shortcuts app. | [automation.md](../development/automation.md#shortcuts-actions) |25| VoiceOver was not tested with a human listener. | [accessibility.md](../reports/accessibility.md#gaps) |26| The Intel (x86_64) slice is built but untested; no clean second Mac was used. | [distribution.md](../release/distribution.md#what-was-not-verified) |27| Benchmarks are single runs of a synthetic document on one machine. | [performance.md](../development/performance.md#results-on-file) |2829## Editing3031| Limitation | Detail |32|---|---|33| Grammar checking, autocorrection and text replacement are not implemented. | [text-engine.md](../architecture/text-engine.md#13-spelling) |34| 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](../architecture/text-engine.md#15-limits) |35| Selected text cannot be dragged out or moved by dragging; RTF, HTML and native fragments are not read from a drop. | [text-engine.md](../architecture/text-engine.md#12-clipboard-drag-and-drop) |36| Bidirectional text: no split caret, logical-order arrow keys, approximate selection rectangles. | [text-engine.md](../architecture/text-engine.md#15-limits) |37| Dictation through the text input client is not exercised by any test. | [text-engine.md](../architecture/text-engine.md#15-limits) |38| Smart typography has no en-dash or ellipsis rule and is not applied to pasted or composed text. | [text-engine.md](../architecture/text-engine.md#10-smart-quotes-and-dashes) |39| A drag that starts with a double or triple click does not extend the selection. | [text-engine.md](../architecture/text-engine.md#11-mouse) |40| Paragraphs of 20,000 UTF-16 units or more are not spell-checked. | [text-engine.md](../architecture/text-engine.md#13-spelling) |41| The launch option `-ORIXPage` has no effect when given on the command line. | [setup.md](../development/setup.md#launch-options) |4243## Layout and pagination4445| Limitation | Detail |46|---|---|47| 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](../architecture/layout-engine.md#limits) |48| Inline boxes (citation, cross-reference, field, note mark, inline image or equation) are unbreakable and can overflow the line. | [layout-engine.md](../architecture/layout-engine.md#limits) |49| One leader style per paragraph; none on hyphenated lines. | [layout-engine.md](../architecture/layout-engine.md#limits) |50| Small capitals and bold depend on the font; only italic is synthesised. | [layout-engine.md](../architecture/layout-engine.md#limits) |51| Footnotes do not split between pages; a note taller than a column overflows. | [pagination.md](../architecture/pagination.md#limits) |52| No column balancing; tables and floats do not span columns. | [pagination.md](../architecture/pagination.md#limits) |53| A paragraph that continues in the next column after wrapping around an earlier paragraph's float keeps its narrowed lines. | [pagination.md](../architecture/pagination.md#limits) |54| Keep with next looks at most five blocks ahead. | [pagination.md](../architecture/pagination.md#limits) |55| Convergence of page references is bounded at four passes, not guaranteed. | [pagination.md](../architecture/pagination.md#limits) |56| 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](../development/performance.md#optimisations-present-in-the-code) |57| 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](../architecture/layout-engine.md#limits) |58| Several pagination rules have no test (space before and after, footnote reserve, float registration, lists of figures and tables). | [pagination.md](../architecture/pagination.md#summary) |59| No unlimited page count is promised; measured sizes are 98 and 487 pages. | [performance.md](../development/performance.md#results-on-file) |6061## Tables6263| Limitation | Detail |64|---|---|65| Cells hold paragraphs only: no nested tables. Tables and breaks exist in the body only. | [text-engine.md](../architecture/text-engine.md#15-limits) |66| Rows do not split across pages; a row taller than a column overflows and is only reported. | [pagination.md](../architecture/pagination.md#limits) |67| The rows of a vertical merge are not kept together across a page break. | [pagination.md](../architecture/pagination.md#limits) |68| Tables ignore floats (they are not narrowed by an exclusion). | [pagination.md](../architecture/pagination.md#limits) |69| A table wider than its column is scaled down and reported. | [layout-engine.md](../architecture/layout-engine.md#tables) |70| Sorting refuses tables with vertical merges. | [text-engine.md](../architecture/text-engine.md#5-editing-operations) |7172## Images and objects7374| Limitation | Detail |75|---|---|76| No charts, SmartArt, grouped shapes, WordArt or picture effects; shapes are six presets with a one-line label. | [docx.md](docx.md#images-shapes-drawings) |77| Text boxes are not objects; on DOCX import their paragraphs are placed after the anchoring paragraph. | [docx.md](docx.md#images-shapes-drawings) |78| A PDF asset is drawn as its first page only. | [layout-engine.md](../architecture/layout-engine.md#the-page-renderer) |79| EMF and WMF pictures are kept as data and may not display. | [docx.md](docx.md#images-shapes-drawings) |80| Resizing an object is not a tracked change. | [text-engine.md](../architecture/text-engine.md#5-editing-operations) |8182## Mathematics8384| Limitation | Detail |85|---|---|86| A subset of LaTeX math mode: no user macros, `align`, `array`, `\underbrace`, `\overbrace`, `\overset`, `\underset`, `\boxed`, `\cancel`, `\phantom`, `\tag`. | [technology-evaluation.md](../research/technology-evaluation.md#6-math) |87| Expressions over 4,000 characters, 24 nesting levels or 400 cells are refused and shown as source. | [security.md](../security.md#mathematics) |88| LaTeX is normalised by a DOCX round trip; LaTeX the converter cannot parse is exported as text inside the equation. | [docx.md](docx.md#equations) |89| In tagged PDF, equations are figures whose description is the LaTeX source, not formula elements. | [pdf.md](../architecture/pdf.md#known-limits) |90| Text inside math is limited to west European and some Cyrillic characters (library limit). | [technology-evaluation.md](../research/technology-evaluation.md#6-math) |9192## References9394| Limitation | Detail |95|---|---|96| Six built-in citation styles; this is not a CSL processor and `.csl` files cannot be loaded. | [references.md](../architecture/references.md#limitations) |97| No note-based styles, no "ibid.". | [references.md](../architecture/references.md#limitations) |98| Titles are printed as stored (no case conversion); no journal, publisher or page-range abbreviation. | [references.md](../architecture/references.md#title-capitalisation) |99| Documented deviations from each style guide. | [references.md](../architecture/references.md#known-deviations) |100| In-text citations are plain text: no italics, no link to the entry. | [references.md](../architecture/references.md#limitations) |101| No DOI lookup, no reference-manager integration (no network). | [references.md](../architecture/references.md) |102| French localisation of citations covers connecting terms only. | [references.md](../architecture/references.md#limitations) |103| BibTeX, RIS and CSL-JSON round-trip losses (`@string` macros, `crossref`, untagged RIS variables). | [references.md](../architecture/references.md#limitations) |104105## Review106107| Limitation | Detail |108|---|---|109| 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](../architecture/text-engine.md#5-editing-operations) |110| Text committed by `unmarkText()` from an input method carries no insertion revision. | [text-engine.md](../architecture/text-engine.md#15-limits) |111| Comparison: differences in paragraph style, paragraph properties, lists, table properties and page setup are reported but cannot be rejected. | [review.md](../architecture/review.md#the-merged-document) |112| Comparison: tables are never reported as moved; removed breaks and generated blocks are reported but not kept. | [review.md](../architecture/review.md#pipeline) |113| Comment text is plain. | [docx.md](docx.md#review) |114| Real-time collaboration is intentionally absent. | [README](../../README.md#privacy) |115116## DOCX117118| Limitation | Detail |119|---|---|120| Perfect Word compatibility is not claimed; nothing was checked in Microsoft Word. | [docx.md](docx.md#known-gaps-worth-knowing-before-relying-on-this) |121| The corpus is small (19 documents, 526 words) and mostly synthetic. | [docx-compatibility.md](../reports/docx-compatibility.md#limits-of-this-report) |122| Layout (line breaks, pagination, fonts) is not compared by any test. | [docx-compatibility.md](../reports/docx-compatibility.md#limits-of-this-report) |123| No XML Schema validation of exported parts. | [docx.md](docx.md#how-this-was-validated--and-how-it-was-not) |124| Dropped with a warning: charts, SmartArt, embedded objects, linked pictures, macros, OLE, ActiveX, digital signatures, glossary, embedded fonts, `altChunk`. | [docx.md](docx.md#package-and-metadata) |125| Approximated with a warning: tracked moves, nested tables, text boxes, content controls, unknown fields, symbol characters, page breaks inside paragraphs. | [docx-compatibility.md](../reports/docx-compatibility.md#import-warnings-by-document) |126| Tracked paragraph formatting and tracked table, section and numbering changes are not imported. | [docx.md](docx.md#review) |127| `settings.xml` is rewritten: compatibility options, protection and mail merge are not kept. | [docx.md](docx.md#package-and-metadata) |128| Identifiers are regenerated on import; `DATE` fields make two exports differ. | [docx.md](docx.md#known-gaps-worth-knowing-before-relying-on-this) |129| ZIP64 packages are refused. | [security.md](../security.md#zip-archives) |130131## Other formats132133| Limitation | Detail |134|---|---|135| Markdown, HTML, RTF and plain text drop what they cannot carry (comments, headers and footers, sections, and more). | [formats.md](formats.md#summary) |136| RTF goes through the system codec: no named styles, footnotes, comments, tracked changes, equations or headers and footers; RTFD is refused. | [formats.md](formats.md#rtf) |137| RTF written by Word, LibreOffice or Pages was not verified. | [formats.md](formats.md#verified) |138| PDF import reads the text layer only, with paragraph heuristics verified on test-generated PDFs only; no OCR. | [formats.md](formats.md#pdf-import-only) |139| Native format: no encryption, no signature, no ZIP64, no incremental save. | [persistence.md](../architecture/persistence.md#what-the-format-does-not-do) |140| A recovered damaged native file stays bound to the damaged file; saving under a new name is advised, not enforced. | [persistence.md](../architecture/persistence.md#damaged-native-files) |141| Native files larger than a few megabytes were not verified. | [formats.md](formats.md#native-orixdoc) |142| Autosave: untitled never-saved documents, a kill during a write and power loss are not covered by the recovery test. | [persistence.md](../architecture/persistence.md#recovery-after-a-kill) |143144## PDF145146| Limitation | Detail |147|---|---|148| No PDF/A or PDF/UA conformance is claimed. | [pdf.md](../architecture/pdf.md#what-is-not-claimed) |149| Structure tags are partial: no table rows or cells, flat lists, untagged headers and footers, no artifacts, no document language. | [pdf.md](../architecture/pdf.md#known-limits) |150| Reading order is drawing order. | [pdf.md](../architecture/pdf.md#known-limits) |151| No colour management, no output intent, no CMYK; bleed is declared but not drawn. | [pdf.md](../architecture/pdf.md#known-limits) |152| Comments are not exported; pending changes are published as accepted. | [pdf.md](../architecture/pdf.md#tracked-changes-and-comments) |153| Font embedding, subsetting, compression and PDF version are whatever Core Graphics produces. | [pdf.md](../architecture/pdf.md#known-limits) |154| The structure-tag test only checks that a structure tree exists. | [pdf.md](../architecture/pdf.md#structure-tags) |155156Note: the "PDF outline" entry under "Known limits" of [automation.md](../development/automation.md#known-limits) describes an earlier implementation that attached the outline with PDFKit. The current publisher writes the outline through `CGPDFContextSetOutline` ([pdf.md](../architecture/pdf.md#what-is-written), test `outlineMirrorsTheHeadings`); the automation tests themselves still do not assert on the outline.157158## On-device AI159160| Limitation | Detail |161|---|---|162| Requires macOS 26 or later with Apple Intelligence available and enabled; unavailable on macOS 15, the deployment target. | [technology-evaluation.md](../research/technology-evaluation.md#9-local-ai) |163| Quality is not measured; output changes with operating-system updates and between machines. | [technology-evaluation.md](../research/technology-evaluation.md#risks-and-open-questions-8) |164| 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](../research/technology-evaluation.md#9-local-ai) |165| The "concise tone" action often returns the text unchanged; the panel reports that no edit was proposed. | [README](../../README.md#local-ai) |166| The model can decline a request. | [technology-evaluation.md](../research/technology-evaluation.md#9-local-ai) |167| Latency figures (1.7–8.5 s per action) are indicative, measured under machine load, and not stored in a report file. | [README](../../README.md#local-ai) |168| Rule-based tools depend on the language models installed with macOS. | [audit.md](../architecture/audit.md#limits) |169170## Automation171172| Limitation | Detail |173|---|---|174| AppleScript is deferred: no scripting dictionary. | [automation.md](../development/automation.md#applescript-deferred) |175| Shortcuts actions never run from Shortcuts; an intent launch would currently activate the app and show the template chooser. | [automation.md](../development/automation.md#shortcuts-actions) |176| Workflows have no conditions or loops, by design. | [automation.md](../development/automation.md#known-limits) |177| Two inputs with the same base name in one batch write to the same output name. | [automation.md](../development/automation.md#known-limits) |178| Automatic updates are not implemented (Sparkle was evaluated). | [technology-evaluation.md](../research/technology-evaluation.md#10b-updates) |179180## Accessibility181182| Limitation | Detail |183|---|---|184| The review is by code inspection, not a certification. | [accessibility.md](../reports/accessibility.md) |185| The canvas exposes flat text: no headings, links, tracked changes, tables, images or equations as structure; a "line" is a paragraph. | [text-engine.md](../architecture/text-engine.md#14-accessibility) |186| Reduce Motion and Increase Contrast are not specifically handled; chrome text does not scale. | [design-system.md](../design/design-system.md#accessibility-conventions) |187| Tertiary text and the light-appearance amber do not reach a 4.5:1 contrast ratio. | [accessibility.md](../reports/accessibility.md#contrast-of-the-token-palette) |188189## Platform and distribution190191| Limitation | Detail |192|---|---|193| macOS 15.0 or later only. | [setup.md](../development/setup.md#requirements) |194| Not sandboxed. | [security.md](../security.md#the-process) |195| Interface in English and Canadian French only; built-in style names are not translated. | [README](../../README.md#localization) |196| The dependency SwiftMath is pinned to an unreleased upstream revision. | [security.md](../security.md#third-party-code) |197
Files main
Menu

Theme