Changelog
Release notes of GoTipe 0.1.0, grouped by package.
0.1.0
The first public release. Every npm package starts at 0.1.0; the Rust crates are not published to crates.io. Licenses per package are in Licensing.
All packages
- Archives contain only built entry points, styles and license files. Every packed export and every ESM and CommonJS entry is checked before release.
@gotipe/core
- Two engines behind one API:
createEditor({ engine: "auto" | "wasm" | "js" })."auto"loads the WASM core and falls back to the JS engine. The@gotipe/core/jsentry has the same API and no reference to@gotipe/wasm, which is an optional peer, for hosts with a strict CSP. - Host integration through
EditorHost:saveAsset,resolveAsset,openLinkandonError;editor.reportError,editor.openLinkandtoSafeHref; the eventserror,editableChangeanddecorationsChange. - Read-only at runtime with
setEditableandisEditable. Links never navigate on their own: Cmd/Ctrl+click, or any click when read-only, goes throughhost.openLink. setContent(doc, { preserveSelection, addToHistory })keeps the caret and never steals focus.- Decoration layers with
setDecorations: inline ranges, widgets, node classes and phantom blocks. Widget text never counts in offsets (createTextWalker). - Atomic validation of documents and transactions; Unicode-safe selection and undo on both engines; transaction filters and previews (
addTransactionFilter,previewTransaction); typed document snapshots; staged command selections; an owned mounted element. Collapsed marks are validated against the node schema, and nested insertions respect customchildTypes. - A transport-free collaboration port for the WASM engine:
enableCollaboration,getCollaborationUpdate,receiveCollaborationUpdate. serializeHtml, a DOM-free document serializer.renderToHtmlfrom@gotipe/core/servertakesclassPrefix,inlineStylesand custom block renderers. Text color and colored highlight marks serialize with inert CSS color validation.- The document palette:
DOCUMENT_TEXT_COLORS,DOCUMENT_HIGHLIGHT_COLORSanddocumentColorStyle(value). A color mark stores the light print color, so exports keep it; editors render palette values through theme tokens, so marks follow light and dark. - Input methods: a composition is committed once from the DOM, and shortcuts match the physical key on non-Latin layouts. A document, history or collaboration change during a composition interrupts it safely, reports the text as a recoverable
COMPOSITION_CONFLICTand emitscompositionInterrupted; presence decorations wait until the composition ends. Shift+Enter inserts a soft break in WebKit too. getDOMSelection()reads the native selection without side effects.- Tasks can have sub-tasks: Tab nests a task under the one above it and Shift+Tab lifts it.
- Structural blocks are inserted into a parent the schema allows; table and column sizes are validated before a change; inserting a block from the toolbar and its slash trigger is one undo step; nested to-do items render in both editor views.
- A new callout has no emoji by default, in the JS and Rust schemas alike. The
agentcallout value is deprecated and serializes as> [!NOTE].
@gotipe/markdown
- A lossless GFM ⇄ GoTipe codec with its own parser in TypeScript and Rust. An unchanged file round-trips byte for byte; after an edit only the changed top-level blocks are rewritten.
- Front matter, HTML, footnotes and link definitions are kept as they are. Block IDs survive re-parsing, and a text ⇄ Markdown offset map supports anchors.
- Lists nested under a task and task lists nested under a list item (
- [ ] afollowed by- [ ] b) are read and written instead of falling back to raw Markdown.
@gotipe/react
- Decorations in
TextRenderer;blockViewsandplaceholderonEditorandEditorContent;GoTipeI18nProvider; image and file blocks through the host. CodeBlock,ToggleBlockandCalloutBlockare exported for custom block views.- Text and highlight colors render through the document palette and follow the theme.
- Tables add a column from a bar to their right and a row from a bar below, outside the scrolling area; a wide table fades at the edge that hides columns.
- Embeds show a card with their site and address; formulas show their TeX centered and are edited as text. Empty blocks say what they will become. Images and files show load errors, offer upload and a link on empty blocks, and format file sizes for the locale.
@gotipe/vue, @gotipe/svelte, @gotipe/solid
- An editor that finishes initializing after its component is torn down is disposed.
@gotipe/vueexposes a reactive document renderer.
@gotipe/block-editor
PageEditor: a page backed by a Markdown file, with blocks, the "/" menu, tables with column types and model suggestions with lane cursors. Markdown goes in and out through@gotipe/markdown, and untouched blocks keep their bytes.ReviewLayer,ReviewBar,LaneAvatarsandReviewApiaccept or reject one or all suggestions, show comments with replies, detect stale suggestions and reveal text in up to 1.5 s, honoringprefers-reduced-motion.PageEditorisBlockEditorwith a Markdown session: it shares the bubble, slash menu, block handle and menus, takesview(notionby default,docs,modern,minimal) andblockViews, and shows no toast of its own when the host handlesonError. The file's leading# headingis the page title (.gotipe-page-title); raw Markdown blocks are.gotipe-raw. Strings are English by default; passlocale="ru"for Russian.BlockEditortakesview,header(PageHead),blockViews,slashCommands,ariaLabel,errorToastandhighlight. An empty page offers quick blocks (starters), a nulleditorshows a skeleton, and reported errors appear as a toast.EditorSkeleton,EditorErrorToastandEditorStartersare exported.- Every table header has a column menu (type, add a row or column, remove the column;
TableColumnButton), and the row under the pointer has a handle to add a row above or below or delete it (TableRowButton,insertRow,deleteRow). - On a wide page, review cards sit in the margin level with their text (
data-review-layout="margin"); a narrow page opens one card by the text. Thedocsview shows a sticky outline of the page's headings. - Toolbar tooltips show their keys and menus show the keys of block types. ⌘J opens the model's command bar and ⌘K the link field.
- Code highlighting is optional:
@gotipe/block-editor/shikiloads Shiki lazily with its JavaScript regex engine and providesgotipeCodeTheme,codeLanguagesandcodeLanguageAliases; or pass your own highlighter toCodeBlockView. SlashMenutakesgroups,renderIcon,renderMetaandlabels; the menu shows group labels, icons and the Markdown shortcut of each block.- Block dragging works with touch and pen (long press, edge scrolling, cancel, one-step undo); Alt-drag moves a whole list; a drop line shows where the block lands.
- The bubble, menus, link field and color row share one overlay surface and icon set. The color picker offers the document palette.
@gotipe/theme
- One source of design tokens: a system font stack (no web fonts), radii by role, and light and dark palettes.
- Views are token sets over the same markup:
notionon:rootand[data-gt-view];[data-gt-view="docs" | "modern" | "minimal"]change only what makes them different. Narrow containers (640 and 359 px) adjust the tokens through@container. base.cssdraws the document of every view;theme.cssadds blocks, menus, panels, review marks and states.page.cssloads both, and there is no separate page theme.tokens.cssimports the generated palette and views. Menus share one overlay surface.- Token groups for the page and text flow (
--gt-page-width,--gt-page-pad-*,--gt-body-*,--gt-h1…h4-*,--gt-flow-*,--gt-indent), interface sizes (--gt-ui-*,--gt-menu-*,--gt-handle-*), tables (--gt-table-add,--gt-table-add-gap,--gt-table-fade,--gt-row-handle-room), the outline (--gt-outline-*), review (--gt-remote-selection-opacity,--gt-spin-duration) and--gt-icon-small. Older names remain as aliases. --gt-*values a host sets on a container reach the content in both themes.- The list bullet lets the pointer through, so a click beside an empty bullet item in Firefox puts the caret in that item.
@gotipe/i18n
createI18n({ locale, locales })with an English fallback; itsplural()method andpluralCategory()follow Russian plural rules.- Built-in
enandrustrings for the page, "/" menu, tables, review, placeholders, bubble, links, colors, menus, block handle, the model's bar, suggestions, page head and editor states, includingtable.rowMenu,table.addRowAboveandtable.addRowBelow.
@gotipe/comments, @gotipe/suggestions, @gotipe/versions
- Persistent comment anchors and replies.
- Anchored suggestions (
before + quote + after, exactly one match) withapplyAnchoredEdits,computeReviewDecorations(binds suggestions and comments to the document and detects stale ones) andrevealDecorations. - Suggestion inverse snapshots, tracked editing and atomic review actions.
- Working comment, review and version history interfaces in
PageEditor, with explicit host persistence.
@gotipe/export
exportToHtml,exportToMarkdown,exportToPlainText,exportToPdfandexportToDocx. PDF and DOCX come from the optional@gotipe/export-wasm, loaded on first use.- The HTML options
classPrefixandincludeStylesapply the same block classes and styles as server rendering. Options a format does not support throw instead of being ignored.
@gotipe/export-wasm
- PDF with GoTipe's own layout and renderer on maintained PDF, shaping and font-subsetting libraries, with bundled Unicode fonts and their license notices.
- A4, Letter and Legal pages, validated margins and font sizes, headers and footers, Unicode text, inline formatting, links, images, nested lists and merged table cells. Long text and code wrap, oversized table rows continue on the next page, and content that cannot be represented fails instead of being dropped.
- Heading bookmarks, a tagged structure in reading order, image alternative text, table and list semantics and XMP metadata. Word selection and emoji variation sequences stay accurate, and copied text is the logical Unicode text.
- DOCX with GoTipe's own OOXML renderer and a maintained ZIP codec: Unicode, relationships, marks, images and metadata. Invalid XML characters are rejected.
- GoTipe Cloud runs the same renderer natively; a fixed corpus checks both against each other.
@gotipe/migration
- Unsupported subtrees are preserved with warnings (
preservedNodes) instead of being discarded. Tiptap camelCase nodes, nested and check lists, Lexical links and text flags, Slate attributes and custom mappings, strict validation, stable source IDs and an optionalcreateIdfactory.
@gotipe/sdk
- Aligned with GoTipe Cloud's authentication, resource envelopes, pagination and errors.