@latentic/live-markdown 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.2.0] - 2026-08-28
+
+### Added
+
+- **A host can theme fenced-code syntax colours.** Each palette entry carries a
+  CSS custom property alongside its colour, and the editor paints
+  `var(--md-code-…, <One Light value>)`, so a dark theme can restyle code.
+  Previously impossible: the editor takes no `extensions` prop and the generated
+  highlight classes are content-hashed, leaving no seam at all.
+
+  The clipboard renderer deliberately keeps literal colours. Pasted HTML arrives
+  with no stylesheet, so a `var()` there resolves to nothing and pastes
+  colourless code into Google Docs or Word — and the document being pasted into
+  is white whatever theme the editor was in.
+
+  Roles are named individually (`--md-code-keyword`, `--md-code-string`, …) even
+  where two share a value, so one can be restyled without the other. A host that
+  sets no variables gets a byte-identical palette: the literal is the fallback.
+
+## [0.1.1] - 2026-08-24
+
+### Added
+
+- `inlineScanRulesFacet`, `scanInline`, `escapeText`/`escapeAttr` and their
+  types are exported. 0.1.0 shipped the seam but left it unreachable: a
+  third-party extension could contribute a rule for a construct Lezer parses
+  (`nodeRulesFacet`, public since 0.0.1) but not for one it does not, which is
+  half a contract.
+
 ## [0.1.0] - 2026-08-24
 
 First release from the editor's own repository, and the first with CI on more

package/dist/index.d.ts

@@ -160,6 +160,57 @@ declare function structural(why: string): NodeRule;
  */
 declare const nodeRulesFacet: Facet<Readonly<Record<string, NodeRule>>, Readonly<Record<string, NodeRule>>>;
 
+/**
+ * Constructs Lezer never parses.
+ *
+ * Wikilinks, `==highlight==`, footnote references and `$math$` are not
+ * CommonMark, so no node exists for any of them and the editor finds each by
+ * scanning text (`codeContext.ts` documents the shared code guard). A renderer
+ * that walks the tree is therefore blind to all four — which is how a table cell
+ * came to show `$440 = 2 \times \frac{22}{7} \times r$` as literal source while
+ * the same expression rendered as mathematics in the paragraph above it.
+ *
+ * A feature contributes its pattern and its markup through this facet; the
+ * string renderers consult the facet and stay ignorant of what the constructs
+ * are. The decoration plugins keep their own viewport-scanning path — the two
+ * paths share the pattern, not the machinery, because one produces decorations
+ * over a live document and the other an HTML string.
+ */
+
+interface InlineScanRule {
+    readonly name: string;
+    /** Global-flagged; the scanner drives `exec` and resets `lastIndex`. */
+    readonly pattern: RegExp;
+    /** Markup for one match. Escaping document text is the rule's job. */
+    render(match: RegExpExecArray): string;
+    /**
+     * Upgrade rendered markup to real DOM, after sanitisation. Only for a
+     * construct whose rendering is DOM rather than markup (KaTeX): the generated
+     * nodes bypass the sanitiser, so a hydrate reads inert text from the element
+     * it replaces and never trusts the document.
+     */
+    hydrate?(root: HTMLElement): void;
+}
+declare const inlineScanRulesFacet: Facet<InlineScanRule, readonly InlineScanRule[]>;
+interface InlineScanMatch {
+    readonly from: number;
+    readonly to: number;
+    readonly html: string;
+}
+/**
+ * Every rule's matches in `text`, in document order, offset by `at`.
+ *
+ * Earliest wins, then longest — two constructs cannot both own one span, and
+ * the alternative (rule declaration order) would make the result depend on
+ * extension load order.
+ */
+declare function scanInline(rules: readonly InlineScanRule[], text: string, at?: number): InlineScanMatch[];
+
+/** Entity-escaping for the string renderers (table cells), which build HTML
+ *  text rather than DOM and so must neutralise markup in document content. */
+declare function escapeText(value: string): string;
+declare function escapeAttr(value: string): string;
+
 /**
  * A syntax tree that reaches `pos`.
  *
@@ -801,4 +852,4 @@ interface ResolveWorkspaceLinkOptions {
 }
 declare function resolveWorkspaceLink(href: string, options: ResolveWorkspaceLinkOptions): ResolvedWorkspaceLink | null;
 
-export { type CaretContextSnapshot, type CodeMirrorEditorMode, CodeMirrorMarkdownEditor, type CodeMirrorMarkdownEditorProps, type ComposedExtension, type DocumentTextChange, type EditorSelectionSnapshot, type Frontmatter, type FrontmatterValue, type HighlightedSpan, IMAGE_EDIT_ALT_EVENT, type ImageEditAltEventDetail, type ImageInsertOptions, type ImageInsertResult, type ImageResolveContext, type MarkdownDocument, type MarkdownExtension, type MermaidRenderResult, type NodeContext, type NodeRule, type NodeRules, type OpenExternalUrl, type Paint, type ResolveImageSrc, type ResolveWorkspaceLinkOptions, type ResolvedWorkspaceLink, type SaveImageBytes, type SourceRange, type ToolbarContribution, blockCommands, buildImageMarkdown, composeExtensions, computeFileDir, defaultResolveImageSrc, dirnamePath, editorBaseTheme, extractImageBlobs, extractImageFiles, footnoteExtension, formatCommands, getCachedMermaidPng, hasUriScheme, headingLine, hideAlways, highlightExtension, highlightFenceSpans, imageInsertHandlers, insertImageBlob, isAbsolutePath, isMermaidFenceInfo, joinPath, line, mark, markdownDecorationsPlugin, mathExtension, mermaidExtension, nodeRulesFacet, onEditorUpdate, parseFrontmatter, parseWikilinkBody, pickImageFileForCaret, raw, renderMermaidToSvg, resolveWikilinkTarget, resolveWorkspaceLink, serializeMarkdown, setFrontmatterField, showImageActionMenu, structural, tableExtension, treeAt, warmMermaidPng, wikilinkExtension };
+export { type CaretContextSnapshot, type CodeMirrorEditorMode, CodeMirrorMarkdownEditor, type CodeMirrorMarkdownEditorProps, type ComposedExtension, type DocumentTextChange, type EditorSelectionSnapshot, type Frontmatter, type FrontmatterValue, type HighlightedSpan, IMAGE_EDIT_ALT_EVENT, type ImageEditAltEventDetail, type ImageInsertOptions, type ImageInsertResult, type ImageResolveContext, type InlineScanMatch, type InlineScanRule, type MarkdownDocument, type MarkdownExtension, type MermaidRenderResult, type NodeContext, type NodeRule, type NodeRules, type OpenExternalUrl, type Paint, type ResolveImageSrc, type ResolveWorkspaceLinkOptions, type ResolvedWorkspaceLink, type SaveImageBytes, type SourceRange, type ToolbarContribution, blockCommands, buildImageMarkdown, composeExtensions, computeFileDir, defaultResolveImageSrc, dirnamePath, editorBaseTheme, escapeAttr, escapeText, extractImageBlobs, extractImageFiles, footnoteExtension, formatCommands, getCachedMermaidPng, hasUriScheme, headingLine, hideAlways, highlightExtension, highlightFenceSpans, imageInsertHandlers, inlineScanRulesFacet, insertImageBlob, isAbsolutePath, isMermaidFenceInfo, joinPath, line, mark, markdownDecorationsPlugin, mathExtension, mermaidExtension, nodeRulesFacet, onEditorUpdate, parseFrontmatter, parseWikilinkBody, pickImageFileForCaret, raw, renderMermaidToSvg, resolveWikilinkTarget, resolveWorkspaceLink, scanInline, serializeMarkdown, setFrontmatterField, showImageActionMenu, structural, tableExtension, treeAt, warmMermaidPng, wikilinkExtension };

package/dist/index.js

@@ -443,23 +443,59 @@ function onEditorUpdate(view, fn) {
   };
 }
 var CODE_PALETTE = [
-  { tag: [tags.keyword, tags.modifier, tags.operatorKeyword], color: "#a626a4" },
-  { tag: [tags.string, tags.special(tags.string)], color: "#50a14f" },
-  { tag: tags.comment, color: "#a0a1a7", fontStyle: "italic" },
-  { tag: [tags.number, tags.bool, tags.null, tags.atom], color: "#986801" },
-  { tag: [tags.function(tags.variableName), tags.function(tags.propertyName)], color: "#4078f2" },
-  { tag: [tags.typeName, tags.className, tags.namespace], color: "#c18401" },
-  { tag: tags.definition(tags.variableName), color: "#e45649" },
-  { tag: tags.propertyName, color: "#4078f2" },
-  { tag: [tags.tagName, tags.self], color: "#e45649" },
-  { tag: tags.attributeName, color: "#986801" },
-  { tag: [tags.regexp, tags.escape], color: "#0184bc" },
-  { tag: tags.invalid, color: "#ca1243" }
+  {
+    tag: [tags.keyword, tags.modifier, tags.operatorKeyword],
+    color: "#a626a4",
+    cssVar: "--md-code-keyword"
+  },
+  {
+    tag: [tags.string, tags.special(tags.string)],
+    color: "#50a14f",
+    cssVar: "--md-code-string"
+  },
+  {
+    tag: tags.comment,
+    color: "#a0a1a7",
+    cssVar: "--md-code-comment",
+    fontStyle: "italic"
+  },
+  {
+    tag: [tags.number, tags.bool, tags.null, tags.atom],
+    color: "#986801",
+    cssVar: "--md-code-literal"
+  },
+  {
+    tag: [tags.function(tags.variableName), tags.function(tags.propertyName)],
+    color: "#4078f2",
+    cssVar: "--md-code-function"
+  },
+  {
+    tag: [tags.typeName, tags.className, tags.namespace],
+    color: "#c18401",
+    cssVar: "--md-code-type"
+  },
+  {
+    tag: tags.definition(tags.variableName),
+    color: "#e45649",
+    cssVar: "--md-code-variable"
+  },
+  { tag: tags.propertyName, color: "#4078f2", cssVar: "--md-code-property" },
+  { tag: [tags.tagName, tags.self], color: "#e45649", cssVar: "--md-code-tag" },
+  { tag: tags.attributeName, color: "#986801", cssVar: "--md-code-attribute" },
+  { tag: [tags.regexp, tags.escape], color: "#0184bc", cssVar: "--md-code-regexp" },
+  { tag: tags.invalid, color: "#ca1243", cssVar: "--md-code-invalid" }
 ];
+function themedColor(spec) {
+  return `var(${spec.cssVar}, ${spec.color})`;
+}
 
 // src/codemirror/code/codeHighlight.ts
 var style = HighlightStyle.define(
-  CODE_PALETTE.map((spec) => ({ tag: spec.tag, color: spec.color, fontStyle: spec.fontStyle }))
+  CODE_PALETTE.map((spec) => ({
+    tag: spec.tag,
+    color: themedColor(spec),
+    fontStyle: spec.fontStyle
+  }))
 );
 var codeHighlight = syntaxHighlighting(style);
 
@@ -5929,6 +5965,6 @@ function CodeMirrorMarkdownEditorInner({
 }
 var CodeMirrorMarkdownEditor = memo(CodeMirrorMarkdownEditorInner);
 
-export { CodeMirrorMarkdownEditor, IMAGE_EDIT_ALT_EVENT, blockCommands, buildImageMarkdown, composeExtensions, computeFileDir, defaultResolveImageSrc, dirnamePath, editorBaseTheme, extractImageBlobs, extractImageFiles, footnoteExtension, formatCommands, getCachedMermaidPng, hasUriScheme, headingLine, hideAlways, highlightExtension, highlightFenceSpans, imageInsertHandlers, insertImageBlob, isAbsolutePath, isMermaidFenceInfo, joinPath, line, mark, markdownDecorationsPlugin, mathExtension, mermaidExtension, nodeRulesFacet, onEditorUpdate, parseFrontmatter, parseWikilinkBody, pickImageFileForCaret, raw, renderMermaidToSvg, resolveWikilinkTarget, resolveWorkspaceLink, serializeMarkdown, setFrontmatterField, showImageActionMenu, structural, tableExtension, treeAt, warmMermaidPng, wikilinkExtension };
+export { CodeMirrorMarkdownEditor, IMAGE_EDIT_ALT_EVENT, blockCommands, buildImageMarkdown, composeExtensions, computeFileDir, defaultResolveImageSrc, dirnamePath, editorBaseTheme, escapeAttr, escapeText, extractImageBlobs, extractImageFiles, footnoteExtension, formatCommands, getCachedMermaidPng, hasUriScheme, headingLine, hideAlways, highlightExtension, highlightFenceSpans, imageInsertHandlers, inlineScanRulesFacet, insertImageBlob, isAbsolutePath, isMermaidFenceInfo, joinPath, line, mark, markdownDecorationsPlugin, mathExtension, mermaidExtension, nodeRulesFacet, onEditorUpdate, parseFrontmatter, parseWikilinkBody, pickImageFileForCaret, raw, renderMermaidToSvg, resolveWikilinkTarget, resolveWorkspaceLink, scanInline, serializeMarkdown, setFrontmatterField, showImageActionMenu, structural, tableExtension, treeAt, warmMermaidPng, wikilinkExtension };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map