Skip to content

InkKit 0.1.3

Choose a tag to compare

@aicayzer aicayzer released this 16 Oct 08:09
· 55 commits to main since this release
121b263

Slash block commands and host-provided note suggestions share one suggestion pop-up.

  • Offer block commands when / is typed on an empty line with slashMenu, off by default. Hosts can select built-in commands with commands and supply their own with customCommands. SlashMenuOptions, SlashCommandName and SlashCommand are exported.
  • Offer matching note names after [[ through the optional WikiLinkAdapter.suggest(query, context) method. Requests support cancellation; obsolete results are ignored. Selecting a suggestion inserts an escaped wiki link in one checked edit.
  • Filter and choose suggestions with the keyboard or pointer in a shared, scrollable pop-up with combobox and listbox semantics.
  • Customize suggestion text with the suggestions* and slash* labels and appearance with the --inkkit-menu-* tokens.

Compatibility review: 0.1.3 is additive pre-1.0 work, so the planned 0.1.3 version is appropriate. No existing API is removed or renamed, and existing calls require no migration. The slash menu remains disabled unless a host enables it. Hosts without WikiLinkAdapter.suggest retain their existing behavior. See the API reference for signatures, defaults and guards.

One editing behavior also changes: a thematic break newly written inside a list item, quote, callout or footnote is written as ___ so it reopens unambiguously. Authored rules keep their spelling unless an edit rewrites their block.

Candidate checks include 3,394 unit tests, fresh offline consumers in Chromium and WebKit, the whole browser suite in both engines, and 25 selected native WKWebView cases on a separate test Mac. No suggestion or pop-up native group exists, so dedicated native suggestion behavior is unverified. The selected native cases cover the fixture bridge, focus, source input, text ranges and shared history; they do not establish consumer-app behavior, VoiceOver, external clipboard destinations or complete IME interoperability. No consumer-app adoption or print campaign was run.

Verification and publication record.