@aicayzer/inkkit 0.3.0 → 0.3.2

package/dist/chunks/{highlight-D6evOlOs.js → highlight-LB7Mkd5W.js}

@@ -1,4 +1,4 @@
-import { a as Decoration, c as PluginKey, d as __toESM, i as $prose, o as DecorationSet, s as Plugin, u as __commonJSMin } from "./core-DrVCeBzK.js";
+import { a as Decoration, c as PluginKey, d as __toESM, i as $prose, o as DecorationSet, s as Plugin, u as __commonJSMin } from "./core-DTew7k7c.js";
 //#region node_modules/.pnpm/highlight.js@11.11.2/node_modules/highlight.js/es/languages/arduino.js
 /** @type LanguageFn */
 function cPlusPlus(hljs) {

package/dist/core.js

@@ -1,2 +1,2 @@
-import { r as InkKitError, t as InkKitEditor } from "./chunks/core-DrVCeBzK.js";
+import { r as InkKitError, t as InkKitEditor } from "./chunks/core-DTew7k7c.js";
 export { InkKitEditor, InkKitError };

package/dist/editor.d.ts

@@ -50,9 +50,9 @@ export interface ImageInsertion {
     alt: string;
     title?: string;
 }
-/** A name in `Keymap`: every format command except `link`, history, block moves, and every table
- *  command. */
-export type ShortcutName = Exclude<FormatCommand, 'link'> | 'undo' | 'redo' | 'moveBlockUp' | 'moveBlockDown' | `table${Capitalize<TableCommand>}`;
+/** A name in `Keymap`: every format command except `link`, history, block moves, list indentation,
+ *  and every table command. */
+export type ShortcutName = Exclude<FormatCommand, 'link'> | 'undo' | 'redo' | 'moveBlockUp' | 'moveBlockDown' | 'indent' | 'outdent' | `table${Capitalize<TableCommand>}`;
 /** Host bindings in ProseMirror key notation, by shortcut name. */
 export type Keymap = Partial<Record<ShortcutName, readonly string[]>>;
 /** Every `ShortcutName`. */
@@ -65,7 +65,7 @@ export interface TextInputPreferences {
     /** Typing a quote or `--` gives a curly quote or a dash, in formatted mode. Off unless true. */
     smartPunctuation?: boolean;
 }
-/** Mount options. Adapters, `labels` and `rendering` are fixed at mount; the rest can change. */
+/** Mount options. Adapters, `labels`, `linkSchemes` and `rendering` are fixed at mount; the rest can change. */
 export interface EditorOptions {
     /** Shows, imports and exports images. Without it and `files`, image Markdown stays literal. */
     images?: ImageAdapter;
@@ -82,6 +82,9 @@ export interface EditorOptions {
     labels?: Partial<EditorLabels>;
     /** See `setKeymap`. */
     keymap?: Keymap;
+    /** Schemes beyond `http`, `https`, `mailto` and `tel` that links may use, such as `things`.
+     *  Fixed at mount. */
+    linkSchemes?: readonly string[];
     rendering?: {
         /** Defaults to true. */
         codeHighlighting?: boolean;
@@ -114,6 +117,7 @@ export interface CommandState extends DocumentVersion {
         replace: boolean;
         replaceSource: boolean;
         insertImages: boolean;
+        appendImages: boolean;
         insertPaths: boolean;
         insertFootnote: boolean;
         editReferenceDefinition: boolean;
@@ -196,12 +200,15 @@ export declare class InkKitEditor {
     private inputPreferences;
     private literalKeys;
     private configuredKeys;
+    private indentKeys;
     private readOnlyKeys;
     private suggestions?;
     private suggestionBase?;
     private changePlugin;
     private keys;
     private readonly events;
+    /** The host's extra link schemes, in lower case. */
+    private readonly linkSchemes;
     /** How many of each state event the host has been sent. */
     private readonly sentEvents;
     private constructor();
@@ -260,6 +267,8 @@ export declare class InkKitEditor {
     get editable(): boolean;
     /** Turns editing on or off for both surfaces. Throws `composition` during text composition. */
     setEditable(editable: boolean): void;
+    /** Supplies native host activation for selection presentation. Null restores browser detection. */
+    setHostActive(active: boolean | null): void;
     /** Replaces the input preferences. A field left out takes its default. Throws `composition`
      *  during text composition. */
     setTextInputPreferences(preferences: TextInputPreferences): void;
@@ -292,6 +301,7 @@ export declare class InkKitEditor {
     private deferSource;
     private rememberTypedStep;
     private showTypedSource;
+    private setSourceValue;
     /**
      * Undoes or redoes typed source that the formatted document has not taken
      * in, on the text alone. Returns whether there was a step to take.
@@ -343,6 +353,7 @@ export declare class InkKitEditor {
      *  throws `destroyed`. */
     destroy(): Promise<void>;
     private keymapPlugin;
+    private indentPlugin;
     private copySourceSelection;
     /** Builds the editor in `root`. It has no document until `loadDocument`. Rejects with
      *  `invalid-argument` for a bad root, handler or option. */
@@ -414,10 +425,18 @@ export declare class InkKitEditor {
     /** Moves focus off InkKit's text surfaces. Focus anywhere else, such as in a host control or a
      *  control InkKit draws, is left alone. */
     blur(expectedGeneration?: number): void;
+    /**
+     * Resolves wiki links and file embeds again, all of them or those whose `target` is named, after
+     * something they point to changed. A file keeps its card until the new answer differs. Changes no
+     * document state, so it works in a read-only editor and during composition. Source and TXT modes
+     * draw no references; named file answers are invalidated and resolved when formatted mode returns.
+     */
+    refreshReferences(targets?: readonly string[], expectedGeneration?: number): void;
     /** Replaces every binding. Keys are in ProseMirror's notation. A key given to two shortcuts goes
      *  to the later one, in the order history, formatting, block moves, tables, so it lands the same
      *  way every time. A table binding passes a key it shares with a block move to the move outside
-     *  a table. */
+     *  a table. List indentation keys apply after all of these, and after the table keys the editor
+     *  keeps for itself. */
     setKeymap(keymap: Keymap): void;
     /** Dropped files land as one paragraph per path at the drop point: in place of an empty block, after
      *  the top-level block otherwise, so a list or quote is not opened up by them. */
@@ -425,6 +444,11 @@ export declare class InkKitEditor {
     /** Inserts images by reference, at the selection or the drop point `at`. Returns false when it
      *  does nothing. */
     insertImages(images: ImageInsertion[], at?: ClientPoint, expectedGeneration?: number): boolean;
+    /** Adds images as the last blocks of the document and leaves everything else as it is: no focus,
+     *  no scrolling, and the selection stays on the text it covered. For a host that attaches images
+     *  to a document the person is not editing at that moment. Returns false when it does nothing. */
+    appendImages(images: ImageInsertion[], expectedGeneration?: number): boolean;
+    private imageBlocks;
     private insertInline;
     private insertBlocks;
     private withMarkRunSelected;
@@ -447,8 +471,9 @@ export declare class InkKitEditor {
     /** Returns whether the document or the marks the next typed text takes changed. */
     format(command: FormatCommand, options?: FormatOptions, expectedGeneration?: number): boolean;
     /**
-     * Refuses a link destination that is empty, that opens anything but a web, mail or phone address,
-     * or that the Markdown writer cannot save so that it reads back the same.
+     * Refuses a link destination that is empty, that opens anything but a web, mail or phone address
+     * or a scheme the host listed, or that the Markdown writer cannot save so that it reads back the
+     * same.
      */
     private checkDestination;
     /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as registerMermaid, r as InkKitError, t as InkKitEditor } from "./chunks/core-DrVCeBzK.js";
+import { n as registerMermaid, r as InkKitError, t as InkKitEditor } from "./chunks/core-DTew7k7c.js";
 //#region src/index.ts
 registerMermaid(async () => (await import("mermaid")).default);
 //#endregion

package/dist/style.css

@@ -1,4 +1,5 @@
 .inkkit-root {
+  --_inkkit-font-size: var(--inkkit-font-size, 15px);
   box-sizing: border-box;
   color-scheme: var(--inkkit-color-scheme, light dark);
   color: var(--inkkit-text-color, CanvasText);
@@ -9,7 +10,7 @@
     system-ui,
     sans-serif
   );
-  font-size: var(--inkkit-font-size, 15px);
+  font-size: var(--_inkkit-font-size);
   line-height: var(--inkkit-line-height, normal);
   -webkit-font-smoothing: antialiased;
   -webkit-text-size-adjust: none;
@@ -60,7 +61,7 @@
     var(--inkkit-padding-bottom, 48px);
   background: transparent;
   color: var(--_inkkit-text);
-  font: calc(var(--inkkit-font-size, 15px) * 1)/var(--inkkit-line-height, 1.5)
+  font: calc(var(--_inkkit-font-size) * 1)/var(--inkkit-line-height, 1.5)
     var(--_inkkit-mono);
 }
 
@@ -75,7 +76,7 @@
 .inkkit-root .inkkit-table-block {
   position: relative;
   margin: 0 0
-    var(--inkkit-paragraph-spacing, calc(var(--inkkit-font-size, 15px) * 0.667));
+    var(--inkkit-paragraph-spacing, calc(var(--_inkkit-font-size) * 0.667));
 }
 .inkkit-root .inkkit-table-scroll {
   overflow-x: auto;
@@ -91,9 +92,9 @@
 .inkkit-root .ProseMirror th {
   position: relative;
   box-sizing: border-box;
-  min-width: calc(var(--inkkit-font-size, 15px) * 4);
-  padding: calc(var(--inkkit-font-size, 15px) * 0.4)
-    calc(var(--inkkit-font-size, 15px) * 0.6);
+  min-width: calc(var(--_inkkit-font-size) * 4);
+  padding: calc(var(--_inkkit-font-size) * 0.4)
+    calc(var(--_inkkit-font-size) * 0.6);
   border: 0 solid var(--_inkkit-rule);
   border-width: 0 1px 1px 0;
   vertical-align: top;
@@ -263,7 +264,7 @@
 .inkkit-root .ProseMirror .inkkit-image-block {
   display: block;
   margin: 0 0
-    var(--inkkit-paragraph-spacing, calc(var(--inkkit-font-size, 15px) * 0.667));
+    var(--inkkit-paragraph-spacing, calc(var(--_inkkit-font-size) * 0.667));
   line-height: 0;
 }
 .inkkit-root .ProseMirror .inkkit-image-block > .inkkit-image {
@@ -301,9 +302,10 @@
   content: '';
   display: block;
   position: absolute;
-  top: -2px;
-  width: 20px;
-  border-top: 2px solid var(--_inkkit-accent);
+  top: 0;
+  width: 2px;
+  height: 1lh;
+  background: var(--_inkkit-accent);
   animation: inkkit-gapcursor-blink 1.1s steps(2, start) infinite;
 }
 @keyframes inkkit-gapcursor-blink {
@@ -497,13 +499,26 @@
   pointer-events: none;
 }
 
-/* The selection plugin draws the selection over the text alone; the engine's own fills the margins too. */
+/* The selection plugin draws the selection over the text alone; the engine's own fills the margins too.
+   The surface needs its own rule: the descendant selector does not reach the surface itself, and WebKit paints that as full-width bars. */
+.inkkit-root .ProseMirror.inkkit-painted-selection::selection,
 .inkkit-root .ProseMirror.inkkit-painted-selection ::selection {
   background: transparent;
 }
 
-.inkkit-root ::highlight(inkkit-selection) {
-  background-color: color-mix(in srgb, var(--_inkkit-accent) 30%, transparent);
+.inkkit-root ::highlight(inkkit-selection),
+.inkkit-root ::selection {
+  background: var(
+    --inkkit-inactive-selection-background,
+    light-dark(#d4d4d4, #555)
+  );
+}
+.inkkit-root.inkkit-selection-active ::highlight(inkkit-selection),
+.inkkit-root.inkkit-selection-active ::selection {
+  background: var(
+    --inkkit-selection-background,
+    color-mix(in srgb, var(--_inkkit-accent) 30%, transparent)
+  );
 }
 
 .inkkit-root .ProseMirror > :first-child {
@@ -512,7 +527,7 @@
 
 .inkkit-root .ProseMirror p {
   margin: 0 0
-    var(--inkkit-paragraph-spacing, calc(var(--inkkit-font-size, 15px) * 0.667));
+    var(--inkkit-paragraph-spacing, calc(var(--_inkkit-font-size) * 0.667));
 }
 
 .inkkit-root .ProseMirror h1,
@@ -520,48 +535,61 @@
 .inkkit-root .ProseMirror h3 {
   line-height: 1.25;
   letter-spacing: -0.01em;
-  margin: calc(var(--inkkit-font-size, 15px) * 1.867) 0
-    calc(var(--inkkit-font-size, 15px) * 0.533);
+  margin: calc(var(--_inkkit-font-size) * 1.867) 0
+    calc(var(--_inkkit-font-size) * 0.533);
 }
 
 .inkkit-root .ProseMirror h1 {
-  font-size: calc(var(--inkkit-font-size, 15px) * 1.733);
+  font-size: calc(var(--_inkkit-font-size) * 1.733);
   font-weight: 700;
 }
 
 .inkkit-root .ProseMirror h2 {
-  font-size: calc(var(--inkkit-font-size, 15px) * 1.4);
+  font-size: calc(var(--_inkkit-font-size) * 1.4);
   font-weight: 700;
 }
 
 .inkkit-root .ProseMirror h3 {
-  font-size: calc(var(--inkkit-font-size, 15px) * 1.133);
+  font-size: calc(var(--_inkkit-font-size) * 1.133);
   font-weight: 600;
 }
 
 .inkkit-root .ProseMirror h4,
 .inkkit-root .ProseMirror h5,
 .inkkit-root .ProseMirror h6 {
-  font-size: calc(var(--inkkit-font-size, 15px) * 1);
+  font-size: calc(var(--_inkkit-font-size) * 1);
   font-weight: 600;
-  margin: calc(var(--inkkit-font-size, 15px) * 1.333) 0
-    calc(var(--inkkit-font-size, 15px) * 0.4);
+  margin: calc(var(--_inkkit-font-size) * 1.333) 0
+    calc(var(--_inkkit-font-size) * 0.4);
 }
 
 .inkkit-root .ProseMirror strong {
   font-weight: 700;
 }
 
-.inkkit-root .ProseMirror a {
+.inkkit-root .ProseMirror a,
+.inkkit-root .inkkit-wiki-link {
   color: var(--_inkkit-accent);
   text-decoration: none;
   text-underline-offset: 2px;
 }
 
-.inkkit-root .ProseMirror a:hover {
+.inkkit-root .ProseMirror a:hover,
+.inkkit-root .inkkit-wiki-link:hover {
   text-decoration: underline;
 }
 
+/* A missing target differs by its line, not only its color, which forced colors replace. */
+.inkkit-root .inkkit-wiki-link[data-missing] {
+  text-decoration: underline dashed;
+}
+
+@media (forced-colors: active) {
+  .inkkit-root .inkkit-wiki-link {
+    color: LinkText;
+  }
+}
+
 /* Held Mod opens a link on click; an empty address opens nothing. */
 .inkkit-root.inkkit-link-modifier .ProseMirror a[href]:not([href='']),
 .inkkit-root.inkkit-link-modifier .inkkit-wiki-link {
@@ -573,25 +601,25 @@
   font-size: 0.88em;
   background: var(--_inkkit-code-bg);
   border-radius: 5px;
-  padding: calc(var(--inkkit-font-size, 15px) * 0.067)
-    calc(var(--inkkit-font-size, 15px) * 0.333);
+  padding: calc(var(--_inkkit-font-size) * 0.067)
+    calc(var(--_inkkit-font-size) * 0.333);
 }
 
 .inkkit-root .ProseMirror pre {
   position: relative;
   font-family: var(--_inkkit-mono);
-  font-size: calc(var(--inkkit-font-size, 15px) * 0.867);
+  font-size: calc(var(--_inkkit-font-size) * 0.867);
   line-height: 1.5;
   background: var(--_inkkit-code-bg);
   border-radius: 8px;
-  padding: calc(var(--inkkit-font-size, 15px) * 0.8)
-    calc(var(--inkkit-font-size, 15px) * 0.933);
-  margin: 0 0 calc(var(--inkkit-font-size, 15px) * 0.8);
+  padding: calc(var(--_inkkit-font-size) * 0.8)
+    calc(var(--_inkkit-font-size) * 0.933);
+  margin: 0 0 calc(var(--_inkkit-font-size) * 0.8);
   overflow-x: auto;
 }
 
 .inkkit-root .ProseMirror pre[data-language] {
-  padding-top: max(calc(var(--inkkit-font-size, 15px) * 2), 30px);
+  padding-top: max(calc(var(--_inkkit-font-size) * 2), 30px);
 }
 
 .inkkit-root .ProseMirror pre .inkkit-copy {
@@ -634,8 +662,8 @@
 }
 
 .inkkit-root .ProseMirror blockquote {
-  margin: 0 0 calc(var(--inkkit-font-size, 15px) * 0.8);
-  padding: 2px 0 2px calc(var(--inkkit-font-size, 15px) * 0.8);
+  margin: 0 0 calc(var(--_inkkit-font-size) * 0.8);
+  padding: 2px 0 2px calc(var(--_inkkit-font-size) * 0.8);
   border-left: 2px solid var(--_inkkit-accent);
 }
 
@@ -650,18 +678,18 @@
 .inkkit-root .ProseMirror hr {
   border: 0;
   border-top: 1px solid var(--_inkkit-rule);
-  margin: calc(var(--inkkit-font-size, 15px) * 1.333) 0;
+  margin: calc(var(--_inkkit-font-size) * 1.333) 0;
 }
 
 .inkkit-root .ProseMirror ul,
 .inkkit-root .ProseMirror ol {
   margin: 0 0
-    var(--inkkit-paragraph-spacing, calc(var(--inkkit-font-size, 15px) * 0.667));
-  padding-left: calc(var(--inkkit-font-size, 15px) * 1.733);
+    var(--inkkit-paragraph-spacing, calc(var(--_inkkit-font-size) * 0.667));
+  padding-left: calc(var(--_inkkit-font-size) * 1.733);
 }
 
 .inkkit-root .ProseMirror li {
-  margin: 0 0 calc(var(--inkkit-font-size, 15px) * 0.267);
+  margin: 0 0 calc(var(--_inkkit-font-size) * 0.267);
 }
 
 .inkkit-root .ProseMirror li > p {
@@ -670,7 +698,7 @@
 
 .inkkit-root .ProseMirror li ul,
 .inkkit-root .ProseMirror li ol {
-  margin-top: calc(var(--inkkit-font-size, 15px) * 0.267);
+  margin-top: calc(var(--_inkkit-font-size) * 0.267);
   margin-bottom: 0;
 }
 
@@ -685,7 +713,7 @@
   /* The box is centered on the first line: 1lh is the line height the item's
      text uses, including when it is normal, and --inkkit-checkbox-offset
      moves the box down for a font whose lines look off-center. */
-  --_inkkit-task-size: calc(var(--inkkit-font-size, 15px) * 0.933);
+  --_inkkit-task-size: calc(var(--_inkkit-font-size) * 0.933);
   --_inkkit-task-top: calc(
     (1lh - var(--_inkkit-task-size)) / 2 + var(--inkkit-checkbox-offset, 0px)
   );
@@ -694,7 +722,7 @@
 .inkkit-root .ProseMirror li[data-item-type='task']::before {
   content: '';
   position: absolute;
-  left: calc(var(--inkkit-font-size, 15px) * -1.667);
+  left: calc(var(--_inkkit-font-size) * -1.667);
   top: var(--_inkkit-task-top);
   width: var(--_inkkit-task-size);
   height: var(--_inkkit-task-size);
@@ -720,10 +748,10 @@
   li[data-item-type='task'][data-checked='true']::after {
   content: '';
   position: absolute;
-  left: calc(var(--inkkit-font-size, 15px) * -1.333);
-  top: calc(var(--_inkkit-task-top) + var(--inkkit-font-size, 15px) * 0.133);
-  width: calc(var(--inkkit-font-size, 15px) * 0.2);
-  height: calc(var(--inkkit-font-size, 15px) * 0.467);
+  left: calc(var(--_inkkit-font-size) * -1.333);
+  top: calc(var(--_inkkit-task-top) + var(--_inkkit-font-size) * 0.133);
+  width: calc(var(--_inkkit-font-size) * 0.2);
+  height: calc(var(--_inkkit-font-size) * 0.467);
   border: solid Canvas;
   border-width: 0 1.5px 1.5px 0;
   transform: rotate(45deg);
@@ -826,28 +854,28 @@
 .inkkit-root .ProseMirror .inkkit-literal-markdown {
   white-space: pre-wrap;
   font-family: var(--_inkkit-mono);
-  font-size: calc(var(--inkkit-font-size, 15px) * 0.9);
+  font-size: calc(var(--_inkkit-font-size) * 0.9);
 }
 
 .inkkit-root .inkkit-footnote-reference {
   cursor: pointer;
   color: var(--_inkkit-accent, currentColor);
-  font-size: calc(var(--inkkit-font-size, 15px) * 0.75);
+  font-size: calc(var(--_inkkit-font-size) * 0.75);
 }
 
 .inkkit-root .inkkit-footnote-definition {
   border-inline-start: 2px solid var(--_inkkit-muted, currentColor);
-  padding-inline-start: calc(var(--inkkit-font-size, 15px) * 1);
+  padding-inline-start: calc(var(--_inkkit-font-size) * 1);
 }
 
 .inkkit-root .inkkit-footnote-definition::before {
   content: '[' attr(data-inkkit-label) ']';
-  font-size: calc(var(--inkkit-font-size, 15px) * 0.8);
+  font-size: calc(var(--_inkkit-font-size) * 0.8);
 }
 
 .inkkit-root .inkkit-reference-definition {
   font-family: var(--_inkkit-mono);
-  font-size: calc(var(--inkkit-font-size, 15px) * 0.8);
+  font-size: calc(var(--_inkkit-font-size) * 0.8);
   opacity: 0.7;
 }
 
@@ -859,8 +887,8 @@
 .inkkit-root .ProseMirror .inkkit-callout {
   --_inkkit-callout-color: var(--_inkkit-accent);
   border-inline-start: 3px solid var(--_inkkit-callout-color);
-  padding: calc(var(--inkkit-font-size, 15px) * 0.65)
-    calc(var(--inkkit-font-size, 15px) * 1);
+  padding: calc(var(--_inkkit-font-size) * 0.65)
+    calc(var(--_inkkit-font-size) * 1);
   background: color-mix(in srgb, var(--_inkkit-callout-color) 7%, transparent);
 }
 
@@ -880,14 +908,14 @@
 .inkkit-root .inkkit-callout-header {
   display: flex;
   align-items: baseline;
-  gap: calc(var(--inkkit-font-size, 15px) * 0.75);
+  gap: calc(var(--_inkkit-font-size) * 0.75);
 }
 
 .inkkit-root [data-inkkit-callout-toggle] {
   color: var(--_inkkit-muted);
   background: transparent;
   border: 0;
-  padding: calc(var(--inkkit-font-size, 15px) * 0.25);
+  padding: calc(var(--_inkkit-font-size) * 0.25);
   cursor: pointer;
 }
 
@@ -909,7 +937,7 @@
 
 .inkkit-root [data-inkkit-comments-visible='true'] .inkkit-comment-block {
   display: block;
-  padding: calc(var(--inkkit-font-size, 15px) * 0.5);
+  padding: calc(var(--_inkkit-font-size) * 0.5);
 }
 
 @media print {
@@ -953,7 +981,7 @@
 }
 .inkkit-root .inkkit-mermaid-preview[data-state='error'] {
   color: var(--inkkit-diagram-error-color, #9b2424);
-  font-size: calc(var(--inkkit-font-size, 15px) * 0.9);
+  font-size: calc(var(--_inkkit-font-size) * 0.9);
 }
 
 /* One ring for every control InkKit draws; the editing surfaces can be set apart. */
@@ -1001,8 +1029,8 @@
   background: var(--inkkit-menu-background, light-dark(#fff, #252529));
   color: var(--inkkit-menu-text, CanvasText);
   box-shadow: var(--inkkit-menu-shadow, 0 4px 18px #0003);
-  font: calc(var(--inkkit-font-size, 15px) * 14 / 15) /
-    calc(var(--inkkit-font-size, 15px) * 1.6)
+  font: calc(var(--_inkkit-font-size) * 14 / 15) /
+    calc(var(--_inkkit-font-size) * 1.6)
     var(--inkkit-font-family, system-ui, sans-serif);
 }
 .inkkit-root .inkkit-suggestions [role='option'] {

package/dist/types.d.ts

@@ -26,7 +26,7 @@ export interface DocumentSnapshot extends DocumentInput, DocumentVersion {
     dirty: boolean;
 }
 /** The closed list of failure codes. The API reference describes each one. */
-export declare const editorErrorCodes: readonly ['not-ready', 'destroyed', 'stale-document', 'composition', 'operation-pending', 'read-only', 'invalid-argument', 'invalid-range', 'preservation', 'image-unavailable', 'diagram-unavailable', 'file-unavailable', 'clipboard-unavailable', 'internal'];
+export declare const editorErrorCodes: readonly ['not-ready', 'destroyed', 'stale-document', 'composition', 'operation-pending', 'read-only', 'invalid-argument', 'invalid-range', 'preservation', 'image-unavailable', 'diagram-unavailable', 'file-unavailable', 'clipboard-unavailable', 'slash-command-failed', 'internal'];
 export type EditorErrorCode = (typeof editorErrorCodes)[number];
 /** Every failure InkKit reports. Hosts branch on `code`; `message` is for logs. When the failure
  *  started elsewhere, such as in an adapter, the host clipboard or the renderer, `cause` holds the
@@ -67,9 +67,13 @@ export interface ImageAdapter {
     }>;
     /** The stored bytes and type of `reference`, for portable clipboard and print output. */
     exportImage(reference: string, context: DocumentContext): Promise<PortableImage>;
+    /** Called for a context-menu request on an image. Inkkit selects the image first. */
+    contextMenu?(reference: string, point: ClientPoint, context: DocumentContext): void;
 }
 /** A wiki link as authored. */
 export interface WikiLinkReference {
+    /** The link's Markdown as the document holds it, such as `[[Plan|Plan]]`. */
+    raw: string;
     /** The note name, with escapes removed. Empty for a link such as `[[#Heading]]`. */
     target: string;
     fragment?: string;
@@ -93,6 +97,8 @@ export interface FileReference {
     reference: string;
     /** `path` for `![alt](destination)`, `wiki` for `![[name]]`. */
     kind: 'path' | 'wiki';
+    /** The embed's Markdown as the document holds it, such as `![alt](a\_b.png)`. */
+    raw: string;
     /** The reference without its fragment. Use it to find the file. */
     target: string;
     /** Everything after the separating `#`, such as `t=10` or `page=3`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicayzer/inkkit",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "A preserving Markdown editor for offline web views and the web",
   "license": "MIT",
   "type": "module",
@@ -38,7 +38,7 @@
   },
   "packageManager": "pnpm@11.0.9",
   "engines": {
-    "node": ">=22.14"
+    "node": ">=26"
   },
   "scripts": {
     "build": "node scripts/clean-build.mjs && tsc -p tsconfig.build.json && vite build --config vite.package.config.ts && node scripts/finish-build.mjs",