@aicayzer/inkkit 0.7.3 → 0.7.4

package/dist/chunks/{core-BI-sSLEL.js → core-B9tnDvUW.js}

@@ -42330,7 +42330,7 @@ function commentSelectionContent(doc, from, to, content) {
 }
 //#endregion
 //#region src/hidden-comments.ts
-var graphemes$1 = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+var graphemes$2 = new Intl.Segmenter(void 0, { granularity: "grapheme" });
 function deletion(event) {
 	const { altKey: alt, ctrlKey: ctrl, metaKey: meta, key } = event;
 	const dir = key === "Backspace" ? -1 : key === "Delete" ? 1 : void 0;
@@ -42373,7 +42373,7 @@ function characterEnd(doc, pos, dir) {
 	const node = dir < 0 ? $pos.nodeBefore : $pos.nodeAfter;
 	if (!node) return void 0;
 	if (!node.isText) return pos + dir * node.nodeSize;
-	const segments = [...graphemes$1.segment(node.text)];
+	const segments = [...graphemes$2.segment(node.text)];
 	return pos + dir * ((dir < 0 ? segments.at(-1) : segments[0])?.segment.length ?? 1);
 }
 /** Where the browser would end a word or line deletion, measured on the rendered text. */
@@ -53759,7 +53759,7 @@ function modeSelectionMap(ctx, source, doc) {
 function hasImageFile(files) {
 	return [...files].some((file) => file.type.startsWith("image/"));
 }
-var graphemes = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+var graphemes$1 = new Intl.Segmenter(void 0, { granularity: "grapheme" });
 /** Owns the source/TXT textarea and the DOM state of its current input. */
 var SourceSurface = class {
 	runtime;
@@ -53900,7 +53900,7 @@ var SourceSurface = class {
 		if (key === "Backspace" || key === "Delete") {
 			const start = this.element.selectionStart;
 			if (start === this.element.selectionEnd) {
-				const segment = graphemes.segment(this.element.value).containing(key === "Backspace" ? start - 1 : start);
+				const segment = graphemes$1.segment(this.element.value).containing(key === "Backspace" ? start - 1 : start);
 				if (!segment) return false;
 				this.element.setSelectionRange(segment.index, segment.index + segment.segment.length);
 			}
@@ -59038,6 +59038,42 @@ function drawsOverlays(win) {
 }
 //#endregion
 //#region src/wiki-view.ts
+/** Whether the style engine reads the text as one color, so a value cannot carry a second
+*  declaration into the property it is written to. */
+function checkedColor(value, what) {
+	const probe = document.createElement("span");
+	if (typeof value === "string") probe.style.color = value;
+	if (probe.style.color === "") throw new TypeError(`Wiki link ${what} must be a color`);
+	return value;
+}
+/** What a link draws beyond its text: an icon, which is decoration drawn as a CSS mask, so a URL
+*  that fetches from the network or runs script is refused, and a tint, a color for a host's look
+*  to fill the link with. Either one that cannot be drawn refuses both. */
+function drawn(presentation) {
+	const { icon, iconColor, tint } = presentation;
+	const result = {};
+	if (tint !== void 0) result.tint = checkedColor(tint, "tint");
+	if (icon === void 0) return result;
+	if (typeof icon !== "string" || !icon.trim()) throw new TypeError("Wiki link icon needs a URL");
+	const url = new URL(icon, document.baseURI);
+	if ([
+		"http:",
+		"https:",
+		"javascript:",
+		"vbscript:"
+	].includes(url.protocol)) throw new TypeError("Wiki link icons must load offline");
+	if (url.protocol === "data:" && !/^image\//i.test(url.pathname)) throw new TypeError("Wiki link icon data URL must be an image");
+	result.icon = iconColor === void 0 ? { url: url.href } : {
+		url: url.href,
+		color: checkedColor(iconColor, "icon color")
+	};
+	return result;
+}
+/** A quoted CSS url() whose text cannot end the string or the declaration early. */
+var cssUrl = (url) => `url("${url.replace(/[\\"\n\r\f]/g, (character) => `\\${character.charCodeAt(0).toString(16)} `)}")`;
+var graphemes = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+/** The first character a reader sees, so a combining mark stays with its base. */
+var firstGrapheme = (label) => graphemes.segment(label)[Symbol.iterator]().next().value?.segment ?? "";
 function wikiLinkView(adapter, runtime) {
 	return $view(wikiLinkSchema, () => (node, view) => {
 		let current = node;
@@ -59045,21 +59081,54 @@ function wikiLinkView(adapter, runtime) {
 		dom.className = "inkkit-wiki-link";
 		dom.setAttribute("role", "link");
 		dom.tabIndex = 0;
+		const text = document.createTextNode("");
+		dom.append(text);
+		let lead;
+		const showLabel = (label, icon) => {
+			if (!icon) {
+				lead?.box.remove();
+				lead = void 0;
+				if (text.data !== label) text.data = label;
+				return;
+			}
+			if (!lead) {
+				const box = document.createElement("span");
+				box.className = "inkkit-wiki-link-lead";
+				const leadText = document.createTextNode("");
+				box.append(leadText);
+				dom.insertBefore(box, text);
+				lead = {
+					box,
+					text: leadText
+				};
+			}
+			const first = firstGrapheme(label);
+			if (lead.text.data !== first) lead.text.data = first;
+			const rest = label.slice(first.length);
+			if (text.data !== rest) text.data = rest;
+			lead.box.style.setProperty("--_inkkit-wiki-icon", cssUrl(icon.url));
+			if (icon.color) lead.box.style.setProperty("--_inkkit-wiki-icon-color", icon.color);
+			else lead.box.style.removeProperty("--_inkkit-wiki-icon-color");
+		};
 		const reference = () => wikiReference(current);
 		const report = (error) => runtime.error?.(coded(error, "file-unavailable"));
 		const render = () => {
 			const { label } = reference();
-			if (dom.textContent !== label) dom.textContent = label;
 			let missing = false;
+			let look = {};
 			if (runtime.active()) {
 				const captured = runtime.capture();
 				try {
 					const result = adapter.resolve?.(reference(), captured.context);
 					missing = captured.isCurrent() && Boolean(result?.missing);
+					if (result && captured.isCurrent() && !missing) look = drawn(result);
 				} catch (error) {
 					report(error);
 				}
 			}
+			showLabel(label, look.icon);
+			if (look.tint) dom.style.setProperty("--_inkkit-wiki-link-tint", look.tint);
+			else dom.style.removeProperty("--_inkkit-wiki-link-tint");
 			if (missing) {
 				dom.dataset.missing = "true";
 				dom.title = runtime.labels.wikiMissing;
@@ -59682,7 +59751,7 @@ async function createMilkdownEditor(root, options, runtime) {
 				return true;
 			}
 		}));
-	}).use(labelsCtx).use(linkSchemesCtx).use(formatInputCtx).use(richTextGuard).use(runtime.plugins.paste).use(visibleClipboard).use(runtime.plugins.suggestions).use(runtime.plugins.keymap).use(createDialect(Boolean(options.images || options.files), Boolean(options.wikiLinks), Boolean(options.files))).use(codeControlCtx).use(codeControlsPlugin(() => runtime.visibleRect())).use(tablePlugins).use(tableBlock).use(runtime.plugins.change).use(runtime.plugins.historyInput).use(history).use(clipboard).use(cursor).use(taskListPlugin((operation) => runtime.mutate(operation))).use(undoTypedRule).use(quoteBackspace).use(calloutEnter).use(literalEnter).use(literalReread).use(listItemBackspace).use(nestedItemEnter).use(rejoinLists).use(movedListItems).use(textInputPolicy).use(runtime.copy ? codeCopyPlugin((text) => runtime.copy?.(text)) : []).use(placeholderPlugin).use(options.rendering?.codeHighlighting === false ? [] : (await import("./highlight-BF7N9czJ.js")).highlightPlugin).use(options.rendering?.diagramPreview === false || !diagramsAvailable() ? [] : mermaidPreview(runtime.diagrams, (error) => runtime.report(error))).use(selectionPlugin(drawn)).use(drawn ? drawnCaretPlugin : []).use($prose(() => search())).use(runtime.plugins.policy).use(options.wikiLinks ? wikiLinkView(options.wikiLinks, {
+	}).use(labelsCtx).use(linkSchemesCtx).use(formatInputCtx).use(richTextGuard).use(runtime.plugins.paste).use(visibleClipboard).use(runtime.plugins.suggestions).use(runtime.plugins.keymap).use(createDialect(Boolean(options.images || options.files), Boolean(options.wikiLinks), Boolean(options.files))).use(codeControlCtx).use(codeControlsPlugin(() => runtime.visibleRect())).use(tablePlugins).use(tableBlock).use(runtime.plugins.change).use(runtime.plugins.historyInput).use(history).use(clipboard).use(cursor).use(taskListPlugin((operation) => runtime.mutate(operation))).use(undoTypedRule).use(quoteBackspace).use(calloutEnter).use(literalEnter).use(literalReread).use(listItemBackspace).use(nestedItemEnter).use(rejoinLists).use(movedListItems).use(textInputPolicy).use(runtime.copy ? codeCopyPlugin((text) => runtime.copy?.(text)) : []).use(placeholderPlugin).use(options.rendering?.codeHighlighting === false ? [] : (await import("./highlight-9qMrVP06.js")).highlightPlugin).use(options.rendering?.diagramPreview === false || !diagramsAvailable() ? [] : mermaidPreview(runtime.diagrams, (error) => runtime.report(error))).use(selectionPlugin(drawn)).use(drawn ? drawnCaretPlugin : []).use($prose(() => search())).use(runtime.plugins.policy).use(options.wikiLinks ? wikiLinkView(options.wikiLinks, {
 		capture: () => runtime.capture(),
 		active: () => runtime.active(),
 		labels: {

package/dist/chunks/{highlight-BF7N9czJ.js → highlight-9qMrVP06.js}

@@ -1,4 +1,4 @@
-import { c as DecorationSet, f as __commonJSMin, l as Plugin, o as $prose, p as __toESM, s as Decoration, u as PluginKey } from "./core-BI-sSLEL.js";
+import { c as DecorationSet, f as __commonJSMin, l as Plugin, o as $prose, p as __toESM, s as Decoration, u as PluginKey } from "./core-B9tnDvUW.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.d.ts

@@ -2,6 +2,6 @@ export { InkKitEditor } from './editor.js';
 export type { EditorEvents, EditorOptions, TextInputPreferences, CommandState, EditingMode, CaretState, Mark, Block, FormatCommand, FormatOptions, KeyInput, ImageInsertion, ShortcutName, Keymap, } from './editor.js';
 export { InkKitError } from './types.js';
 export { normalizeLinkAddress, canOpenLink } from './link-address.js';
-export type { DocumentFormat, TextDocumentFormat, TextDocumentInput, RichTextDocumentInput, TextDocumentSnapshot, RichTextDocumentSnapshot, RichTextDocument, RichTextBlock, RichTextListItem, RichTextTableCell, RichTextInline, RichTextMark, FormatLoss, FormatLossCode, ConvertedDocument, FormatPromise, OfferedFormat, EditorLabels, Heading, TableCommand, TableOptions, BlockMoveDirection, DocumentContext, DocumentInput, DocumentSnapshot, DocumentVersion, EditorErrorCode, ImageAdapter, ImageImportContext, WikiLinkReference, WikiLinkAdapter, FileReference, ClientPoint, FileContext, FilePresentation, FileAdapter, CapturedImage, PortableImage, ClipboardInput, ClipboardOutput, ClipboardScope, ClipboardImage, ClipboardDiagram, PrintableDocument, PrintableWarning, TextRange, FindState, FindSession, ReadableTextSnapshot, TextRect, ViewportInsets, ViewportOptions, ViewportSnapshot, } from './types.js';
+export type { DocumentFormat, TextDocumentFormat, TextDocumentInput, RichTextDocumentInput, TextDocumentSnapshot, RichTextDocumentSnapshot, RichTextDocument, RichTextBlock, RichTextListItem, RichTextTableCell, RichTextInline, RichTextMark, FormatLoss, FormatLossCode, ConvertedDocument, FormatPromise, OfferedFormat, EditorLabels, Heading, TableCommand, TableOptions, BlockMoveDirection, DocumentContext, DocumentInput, DocumentSnapshot, DocumentVersion, EditorErrorCode, ImageAdapter, ImageImportContext, WikiLinkPresentation, WikiLinkReference, WikiLinkAdapter, FileReference, ClientPoint, FileContext, FilePresentation, FileAdapter, CapturedImage, PortableImage, ClipboardInput, ClipboardOutput, ClipboardScope, ClipboardImage, ClipboardDiagram, PrintableDocument, PrintableWarning, TextRange, FindState, FindSession, ReadableTextSnapshot, TextRect, ViewportInsets, ViewportOptions, ViewportSnapshot, } from './types.js';
 export type { SlashMenuOptions, SlashCommandName, SlashCommand } from './types.js';
 export type { DiagnosticReport, DiagnosticEvent, DiagnosticState, DiagnosticPresentation, } from './diagnostics.js';

package/dist/core.js

@@ -1,2 +1,2 @@
-import { a as InkKitError, n as normalizeLinkAddress, r as InkKitEditor, t as canOpenLink } from "./chunks/core-BI-sSLEL.js";
+import { a as InkKitError, n as normalizeLinkAddress, r as InkKitEditor, t as canOpenLink } from "./chunks/core-B9tnDvUW.js";
 export { InkKitEditor, InkKitError, canOpenLink, normalizeLinkAddress };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as InkKitError, i as registerDiagram, n as normalizeLinkAddress, r as InkKitEditor, t as canOpenLink } from "./chunks/core-BI-sSLEL.js";
+import { a as InkKitError, i as registerDiagram, n as normalizeLinkAddress, r as InkKitEditor, t as canOpenLink } from "./chunks/core-B9tnDvUW.js";
 //#region node_modules/.pnpm/dompurify@3.4.17/node_modules/dompurify/dist/purify.es.mjs
 /*! @license DOMPurify 3.4.17 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.4.17/LICENSE */
 function _OverloadYield(e, d) {

package/dist/style.css

@@ -679,27 +679,90 @@
   font-weight: 700;
 }
 
-.inkkit-root .ProseMirror a,
-.inkkit-root .inkkit-wiki-link {
+.inkkit-root .ProseMirror a {
   color: var(--_inkkit-accent);
   text-decoration: none;
   text-underline-offset: 2px;
 }
 
-.inkkit-root .ProseMirror a:hover,
-.inkkit-root .inkkit-wiki-link:hover {
+.inkkit-root .ProseMirror a:hover {
   text-decoration: underline;
 }
 
+/* A wiki link reads each part of its look from a variable whose default is the plain look. */
+.inkkit-root .inkkit-wiki-link {
+  color: var(--inkkit-wiki-link-color, var(--_inkkit-accent));
+  text-decoration-line: var(--inkkit-wiki-link-underline, none);
+  text-decoration-style: solid;
+  text-decoration-thickness: var(--inkkit-wiki-link-underline-thickness, auto);
+  text-decoration-color: var(--inkkit-wiki-link-underline-color, currentcolor);
+  text-underline-offset: var(--inkkit-wiki-link-underline-offset, 2px);
+  padding: var(--inkkit-wiki-link-padding-block, 0)
+    var(--inkkit-wiki-link-padding-inline, 0);
+  border-radius: var(--inkkit-wiki-link-radius, 0);
+  /* The link's tint, when it has one, mixes into the host's background by the strength the host
+     gives it. The host cannot read the tint itself: a variable it sets on the root is read there,
+     where the link's own custom property does not exist. */
+  background-color: color-mix(
+    in srgb,
+    var(
+        --_inkkit-wiki-link-tint,
+        var(--inkkit-wiki-link-background, transparent)
+      )
+      var(--inkkit-wiki-link-tint-strength, 0%),
+    var(--inkkit-wiki-link-background, transparent)
+  );
+  /* A link that wraps keeps its padding and corners on every line. */
+  -webkit-box-decoration-break: clone;
+  box-decoration-break: clone;
+}
+
+.inkkit-root .inkkit-wiki-link:hover {
+  color: var(
+    --inkkit-wiki-link-hover-color,
+    var(--inkkit-wiki-link-color, var(--_inkkit-accent))
+  );
+  text-decoration-line: var(--inkkit-wiki-link-hover-underline, 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;
+  text-decoration-line: underline;
+  text-decoration-style: dashed;
+}
+
+/* The icon is generated content before the link's first character, so it adds no text, no caret
+   position and nothing to copy. It is an inline-block with a size of its own because WebKit
+   paints the whole box of an inline element in the mask's color. A line may break either side of
+   such a box, so the character it sits before is held with it by no-wrap. */
+.inkkit-root .inkkit-wiki-link-lead {
+  white-space: nowrap;
+}
+
+.inkkit-root .inkkit-wiki-link-lead::before {
+  content: '';
+  display: var(--inkkit-wiki-link-icon-display, inline-block);
+  width: var(--inkkit-wiki-link-icon-size, 0.9em);
+  height: var(--inkkit-wiki-link-icon-size, 0.9em);
+  margin-inline-end: var(--inkkit-wiki-link-icon-gap, 0.3em);
+  /* Centers the square on the text's height. */
+  vertical-align: calc(0.35em - var(--inkkit-wiki-link-icon-size, 0.9em) / 2);
+  background-color: var(--_inkkit-wiki-icon-color, currentColor);
+  mask-image: var(--_inkkit-wiki-icon);
+  mask-repeat: no-repeat;
+  mask-position: center;
+  mask-size: 100% 100%;
 }
 
 @media (forced-colors: active) {
   .inkkit-root .inkkit-wiki-link {
     color: LinkText;
   }
+
+  .inkkit-root .inkkit-wiki-link-lead::before {
+    forced-color-adjust: none;
+    background-color: LinkText;
+  }
 }
 
 /* Held Mod opens a link on click; an empty address opens nothing. */
@@ -1136,6 +1199,7 @@
   }
 
   .inkkit-root .inkkit-comment,
+  .inkkit-root .inkkit-wiki-link-lead::before,
   .inkkit-root [data-inkkit-callout-toggle],
   .inkkit-root .ProseMirror pre .inkkit-copy,
   .inkkit-root .inkkit-table-controls,

package/dist/types.d.ts

@@ -174,14 +174,27 @@ export interface WikiLinkReference {
     /** The text shown: the alias, or the target and fragment. */
     label: string;
 }
+/** How a resolved wiki link is drawn, beyond its text. */
+export interface WikiLinkPresentation {
+    /** An image drawn as a mask before the link text, such as a data URL of an SVG. It stays with the
+     *  first character of the link and is decoration only. A `missing` link ignores it. */
+    icon?: string;
+    /** The icon's CSS color: a color value or a `var()` reference. Without it, or with an undefined
+     *  variable, the icon takes the link text's color. */
+    iconColor?: string;
+    /** A CSS color for a host's look to fill the link with, such as the tint of its kind of item. It
+     *  is a color value or a `var()` reference, and a link without one fills with the host's plain
+     *  background. A `missing` link ignores it. */
+    tint?: string;
+}
 /** Resolves and opens wiki links. The host owns lookup, permissions and navigation. */
 export interface WikiLinkAdapter {
     /** Matches note names for a typed `[[` query. Late answers are ignored. */
     suggest?(query: string, context: FileContext): Promise<readonly string[]>;
-    /** Whether the target is missing, for presentation only. */
-    resolve?(reference: WikiLinkReference, context: DocumentContext): {
+    /** Whether the target is missing, and how to draw it if it is not, for presentation only. */
+    resolve?(reference: WikiLinkReference, context: DocumentContext): ({
         missing?: boolean;
-    } | undefined;
+    } & WikiLinkPresentation) | undefined;
     /** Called by Mod-click, and by Enter or Space on the focused link. */
     open(reference: WikiLinkReference, context: DocumentContext): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicayzer/inkkit",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "A preserving Markdown editor for offline web views and the web",
   "license": "MIT",
   "type": "module",