svelte-highlight 7.21.0 → 7.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (232) hide show
  1. package/CodeWindow.svelte +35 -11
  2. package/CodeWindow.svelte.d.ts +7 -1
  3. package/HighlightStream.svelte +22 -0
  4. package/HighlightStream.svelte.d.ts +4 -1
  5. package/LangTag.svelte +4 -0
  6. package/LineNumbers.svelte +1 -0
  7. package/MarkdownStream.svelte +202 -0
  8. package/MarkdownStream.svelte.d.ts +100 -0
  9. package/README.md +402 -6
  10. package/action.d.ts +16 -2
  11. package/action.js +92 -5
  12. package/engine.d.ts +29 -1
  13. package/engine.js +38 -3
  14. package/fence.d.ts +76 -4
  15. package/fence.js +274 -3
  16. package/index.d.ts +1 -0
  17. package/index.js +1 -0
  18. package/languages/agda.js +1 -1
  19. package/languages/aliases.d.ts +7 -0
  20. package/languages/aliases.js +4 -0
  21. package/languages/all.js +25 -1
  22. package/languages/alloy.d.ts +2 -0
  23. package/languages/alloy.js +2 -0
  24. package/languages/angular.js +1 -1
  25. package/languages/assemblyscript.js +1 -1
  26. package/languages/astro.js +1 -1
  27. package/languages/asymptote.d.ts +2 -0
  28. package/languages/asymptote.js +2 -0
  29. package/languages/baml.js +1 -1
  30. package/languages/bend.js +1 -1
  31. package/languages/bibtex.js +1 -1
  32. package/languages/bicep.js +1 -1
  33. package/languages/bitbake.js +1 -1
  34. package/languages/blade.js +1 -1
  35. package/languages/blockdiag.d.ts +2 -0
  36. package/languages/blockdiag.js +2 -0
  37. package/languages/blueprint.js +1 -1
  38. package/languages/bpftrace.js +1 -1
  39. package/languages/bqn.js +1 -1
  40. package/languages/bsv.d.ts +2 -0
  41. package/languages/bsv.js +2 -0
  42. package/languages/c.js +1 -1
  43. package/languages/c3.js +1 -1
  44. package/languages/caddy.js +1 -1
  45. package/languages/cairo.js +1 -1
  46. package/languages/casbin.d.ts +2 -0
  47. package/languages/casbin.js +2 -0
  48. package/languages/cedar.js +1 -1
  49. package/languages/cel.js +1 -1
  50. package/languages/choicescript.d.ts +2 -0
  51. package/languages/choicescript.js +2 -0
  52. package/languages/cisco.js +1 -1
  53. package/languages/civet.js +1 -1
  54. package/languages/clarity.js +1 -1
  55. package/languages/codeql.js +1 -1
  56. package/languages/cql.js +1 -1
  57. package/languages/crontab.js +1 -1
  58. package/languages/csharp.js +1 -1
  59. package/languages/cue.js +1 -1
  60. package/languages/cypher.js +1 -1
  61. package/languages/d2.js +1 -1
  62. package/languages/dafny.d.ts +2 -0
  63. package/languages/dafny.js +2 -0
  64. package/languages/dart.js +1 -1
  65. package/languages/datalog.js +1 -1
  66. package/languages/dax.js +1 -1
  67. package/languages/dbml.d.ts +2 -0
  68. package/languages/dbml.js +2 -0
  69. package/languages/dhall.js +1 -1
  70. package/languages/dialog.d.ts +2 -0
  71. package/languages/dialog.js +2 -0
  72. package/languages/djot.js +1 -1
  73. package/languages/dotenv.js +1 -1
  74. package/languages/dtrace.js +1 -1
  75. package/languages/earthfile.js +1 -1
  76. package/languages/ejs.js +1 -1
  77. package/languages/esql.js +1 -1
  78. package/languages/fennel.js +1 -1
  79. package/languages/fish.js +1 -1
  80. package/languages/flux.js +1 -1
  81. package/languages/fstar.d.ts +2 -0
  82. package/languages/fstar.js +2 -0
  83. package/languages/gdscript.js +1 -1
  84. package/languages/gdshader.js +1 -1
  85. package/languages/gleam.js +1 -1
  86. package/languages/gnuplot.d.ts +2 -0
  87. package/languages/gnuplot.js +2 -0
  88. package/languages/go.js +1 -1
  89. package/languages/groq.js +1 -1
  90. package/languages/haproxy.js +1 -1
  91. package/languages/harlowe.d.ts +2 -0
  92. package/languages/harlowe.js +2 -0
  93. package/languages/hcl.js +1 -1
  94. package/languages/heex.js +3 -1
  95. package/languages/helm.js +1 -1
  96. package/languages/hlsl.js +1 -1
  97. package/languages/hocon.js +1 -1
  98. package/languages/hurl.js +1 -1
  99. package/languages/idris.js +1 -1
  100. package/languages/imba.js +1 -1
  101. package/languages/index.d.ts +48 -0
  102. package/languages/index.js +24 -0
  103. package/languages/ink.js +1 -1
  104. package/languages/java.js +1 -1
  105. package/languages/javascript.js +1 -1
  106. package/languages/jinja.js +1 -1
  107. package/languages/jmespath.js +1 -1
  108. package/languages/jq.js +1 -1
  109. package/languages/json5.js +1 -1
  110. package/languages/jsonata.js +1 -1
  111. package/languages/jsonnet.js +1 -1
  112. package/languages/just.js +1 -1
  113. package/languages/kcl.js +1 -1
  114. package/languages/kconfig.js +1 -1
  115. package/languages/kdl.js +1 -1
  116. package/languages/koka.js +1 -1
  117. package/languages/kotlin.js +1 -1
  118. package/languages/kql.js +1 -1
  119. package/languages/lean.js +1 -1
  120. package/languages/likec4.d.ts +2 -0
  121. package/languages/likec4.js +2 -0
  122. package/languages/liquid.js +2 -1
  123. package/languages/logql.js +1 -1
  124. package/languages/lookml.js +1 -1
  125. package/languages/luau.js +1 -1
  126. package/languages/markdoc.js +1 -1
  127. package/languages/marko.js +1 -1
  128. package/languages/mdx.js +2 -1
  129. package/languages/mermaid.js +1 -1
  130. package/languages/modelfile.js +1 -1
  131. package/languages/mojo.js +1 -1
  132. package/languages/move.js +1 -1
  133. package/languages/nextflow.d.ts +2 -0
  134. package/languages/nextflow.js +2 -0
  135. package/languages/nickel.js +1 -1
  136. package/languages/nomnoml.d.ts +2 -0
  137. package/languages/nomnoml.js +2 -0
  138. package/languages/nushell.js +1 -1
  139. package/languages/odin.js +1 -1
  140. package/languages/openfga.d.ts +2 -0
  141. package/languages/openfga.js +2 -0
  142. package/languages/org.js +1 -1
  143. package/languages/pikchr.d.ts +2 -0
  144. package/languages/pikchr.js +2 -0
  145. package/languages/pkl.js +1 -1
  146. package/languages/plsql.js +1 -1
  147. package/languages/polar.js +1 -1
  148. package/languages/powerquery.js +1 -1
  149. package/languages/promql.js +1 -1
  150. package/languages/prql.js +1 -1
  151. package/languages/purescript.js +1 -1
  152. package/languages/python.js +1 -1
  153. package/languages/racket.js +1 -1
  154. package/languages/raku.js +1 -1
  155. package/languages/regex.js +1 -1
  156. package/languages/roc.js +1 -1
  157. package/languages/ron.js +1 -1
  158. package/languages/rust.js +1 -1
  159. package/languages/semver.d.ts +2 -0
  160. package/languages/semver.js +2 -0
  161. package/languages/shaderlab.js +1 -1
  162. package/languages/slint.js +1 -1
  163. package/languages/smithy.js +1 -1
  164. package/languages/snort.js +1 -1
  165. package/languages/solidity.js +1 -1
  166. package/languages/spade.d.ts +2 -0
  167. package/languages/spade.js +2 -0
  168. package/languages/sparql.js +1 -1
  169. package/languages/spicedb.d.ts +2 -0
  170. package/languages/spicedb.js +2 -0
  171. package/languages/splunk.js +1 -1
  172. package/languages/structurizr.js +1 -1
  173. package/languages/surrealql.js +1 -1
  174. package/languages/svelte.js +1 -1
  175. package/languages/swift.js +1 -1
  176. package/languages/systemd.js +1 -1
  177. package/languages/tlaplus.d.ts +2 -0
  178. package/languages/tlaplus.js +2 -0
  179. package/languages/toml.js +1 -1
  180. package/languages/traceql.js +1 -1
  181. package/languages/tsq.js +1 -1
  182. package/languages/tsql.js +1 -1
  183. package/languages/typescript.js +1 -1
  184. package/languages/typespec.js +1 -1
  185. package/languages/url.d.ts +2 -0
  186. package/languages/url.js +2 -0
  187. package/languages/v.js +1 -1
  188. package/languages/vcl.js +1 -1
  189. package/languages/verse.js +1 -1
  190. package/languages/veryl.d.ts +2 -0
  191. package/languages/veryl.js +2 -0
  192. package/languages/vrl.js +1 -1
  193. package/languages/vue.js +1 -1
  194. package/languages/vyper.js +1 -1
  195. package/languages/wdl.d.ts +2 -0
  196. package/languages/wdl.js +2 -0
  197. package/languages/wgsl.js +1 -1
  198. package/languages/wit.js +1 -1
  199. package/languages/yara.js +1 -1
  200. package/languages/zig.js +1 -1
  201. package/package.json +30 -2
  202. package/search.css +16 -0
  203. package/search.d.ts +92 -0
  204. package/search.js +518 -0
  205. package/styles/blacklight-dark.css +1 -1
  206. package/styles/blacklight-dark.js +1 -1
  207. package/styles/cyanotype-light.css +1 -1
  208. package/styles/cyanotype-light.js +1 -1
  209. package/styles/dusk-dark.css +1 -1
  210. package/styles/dusk-dark.js +1 -1
  211. package/styles/peat-dark.css +1 -1
  212. package/styles/peat-dark.js +1 -1
  213. package/styles/thermal-dark.css +1 -1
  214. package/styles/thermal-dark.js +1 -1
  215. package/styles/wet-plate-dark.css +1 -1
  216. package/styles/wet-plate-dark.js +1 -1
  217. package/themes/blacklight-dark.css +1 -1
  218. package/themes/blacklight-dark.js +2 -2
  219. package/themes/cyanotype-light.css +1 -1
  220. package/themes/cyanotype-light.js +2 -2
  221. package/themes/dusk-dark.css +1 -1
  222. package/themes/dusk-dark.js +2 -2
  223. package/themes/peat-dark.css +1 -1
  224. package/themes/peat-dark.js +2 -2
  225. package/themes/thermal-dark.css +1 -1
  226. package/themes/thermal-dark.js +2 -2
  227. package/themes/wet-plate-dark.css +1 -1
  228. package/themes/wet-plate-dark.js +2 -2
  229. package/transformers.d.ts +44 -0
  230. package/transformers.js +154 -0
  231. package/worker.d.ts +45 -0
  232. package/worker.js +379 -0
package/CodeWindow.svelte CHANGED
@@ -9,17 +9,29 @@
9
9
  <div class="code-window {variant}" {...$$restProps}>
10
10
  <div class="titlebar">
11
11
  {#if variant === "macos"}
12
- <span class="dots" aria-hidden="true">
13
- <span class="dot close"></span>
14
- <span class="dot minimize"></span>
15
- <span class="dot maximize"></span>
12
+ <span class="titlebar-lead">
13
+ <span class="dots" aria-hidden="true">
14
+ <span class="dot close"></span>
15
+ <span class="dot minimize"></span>
16
+ <span class="dot maximize"></span>
17
+ </span>
16
18
  </span>
17
19
  {:else if variant === "terminal"}
18
- <span class="prompt" aria-hidden="true">&gt;_</span>
20
+ <span class="titlebar-lead">
21
+ <span class="prompt" aria-hidden="true">&gt;_</span>
22
+ </span>
19
23
  {/if}
20
24
 
21
25
  {#if title}
22
- <span class="title">{title}</span>
26
+ <span class="title" {title}>{title}</span>
27
+ {/if}
28
+
29
+ {#if variant !== "plain"}
30
+ <!-- titlebar content wider than the leading chrome will unbalance the
31
+ centering above -- an accepted trade-off, not a bug. -->
32
+ <span class="titlebar-end"><slot name="titlebar" /></span>
33
+ {:else}
34
+ <slot name="titlebar" />
23
35
  {/if}
24
36
  </div>
25
37
 
@@ -84,12 +96,24 @@
84
96
  color: var(--prompt-color, inherit);
85
97
  }
86
98
 
99
+ .titlebar-lead,
100
+ .titlebar-end {
101
+ display: flex;
102
+ align-items: center;
103
+ flex: 1 1 0;
104
+ min-width: 0;
105
+ }
106
+
107
+ .titlebar-end {
108
+ justify-content: flex-end;
109
+ }
110
+
87
111
  .title {
88
- /* Center title across titlebar, ignoring dots/prompt. */
89
- position: absolute;
90
- left: 50%;
91
- transform: translateX(-50%);
92
- max-width: 70%;
112
+ /* Sandwiched between equal-width .titlebar-lead/.titlebar-end, so it
113
+ centers in the space actually left over instead of the full bar. */
114
+ flex: 1 1 0;
115
+ min-width: 0;
116
+ text-align: center;
93
117
  overflow: hidden;
94
118
  white-space: nowrap;
95
119
  text-overflow: ellipsis;
@@ -9,7 +9,8 @@ export type CodeWindowProps = HTMLAttributes<HTMLDivElement> & {
9
9
  variant?: "macos" | "terminal" | "plain";
10
10
 
11
11
  /**
12
- * Title bar text.
12
+ * Title bar text. Also becomes the title bar's native HTML `title`
13
+ * attribute, so a truncated title is readable as a hover/focus tooltip.
13
14
  * @default ""
14
15
  */
15
16
  title?: string;
@@ -127,6 +128,11 @@ export type CodeWindowEvents = {};
127
128
 
128
129
  export type CodeWindowSlots = {
129
130
  default: {};
131
+
132
+ /**
133
+ * Optional content rendered in the mirrored trailing region of the title bar.
134
+ */
135
+ titlebar: {};
130
136
  };
131
137
 
132
138
  export default class CodeWindow extends SvelteComponentTyped<
@@ -379,6 +379,28 @@
379
379
  }
380
380
  }
381
381
 
382
+ /**
383
+ * Scroll a given line into the rendered window.
384
+ * @param {number} line
385
+ */
386
+ export function scrollToLine(line) {
387
+ if (!container) return;
388
+ if (virtualize) {
389
+ const target = Math.max(0, Math.min(line, vLineCount)) * vLineHeight;
390
+ const maxScrollTop = Math.max(
391
+ 0,
392
+ container.scrollHeight - container.clientHeight,
393
+ );
394
+ container.scrollTop = Math.max(0, Math.min(target, maxScrollTop));
395
+ vScrollTop = container.scrollTop;
396
+ computeVirtualWindow();
397
+ } else {
398
+ container
399
+ .querySelector(`[data-line="${line}"]`)
400
+ ?.scrollIntoView({ block: "nearest" });
401
+ }
402
+ }
403
+
382
404
  // Mirrors `scrollToBottom`/the shrink-clamp in `HighlightVirtual`, merged:
383
405
  // while streaming with `autoScroll`, stick to the (growing) bottom; once
384
406
  // the user scrolls away, just keep the scroll position in bounds.
@@ -132,4 +132,7 @@ export default class HighlightStream extends SvelteComponentTyped<
132
132
  HighlightStreamProps,
133
133
  HighlightStreamEvents,
134
134
  Record<string, never>
135
- > {}
135
+ > {
136
+ /** Scroll a given line into the rendered window. */
137
+ scrollToLine(line: number): void;
138
+ }
package/LangTag.svelte CHANGED
@@ -32,4 +32,8 @@
32
32
 
33
33
  <style>
34
34
  @import "./langtag.css";
35
+
36
+ pre {
37
+ direction: ltr;
38
+ }
35
39
  </style>
@@ -140,6 +140,7 @@
140
140
 
141
141
  pre {
142
142
  margin: 0;
143
+ direction: ltr;
143
144
  }
144
145
 
145
146
  table,
@@ -0,0 +1,202 @@
1
+ <script>
2
+ /**
3
+ * Growing Markdown buffer. On change, `splitter.append` is used when the
4
+ * new value starts with the previous one; otherwise the whole buffer is
5
+ * replaced via `splitter.set`.
6
+ * @type {string}
7
+ */
8
+ export let text = "";
9
+
10
+ /**
11
+ * Stream finished: forwarded to every fence's `HighlightStream` as
12
+ * `done || !segment.open`.
13
+ * @type {boolean}
14
+ */
15
+ export let done = false;
16
+
17
+ /**
18
+ * Resolves a fence's language. Cached per canonical name for the
19
+ * component's lifetime.
20
+ * @type {(lang: string | undefined, segment: import("./fence.d.ts").FenceSegment) => import("./languages").LanguageType<string> | Promise<import("./languages").LanguageType<string>> | undefined}
21
+ */
22
+ export let resolveLanguage = defaultResolveLanguage;
23
+
24
+ /** @type {boolean} */
25
+ export let caret = true;
26
+
27
+ /** @type {boolean} */
28
+ export let autoScroll = true;
29
+
30
+ /**
31
+ * Announced once, by the last fence only, when `done` becomes `true`.
32
+ * @type {string}
33
+ */
34
+ export let doneText = "Code finished streaming";
35
+
36
+ import { createEventDispatcher } from "svelte";
37
+ import { createFenceSplitter } from "./fence.js";
38
+ import HighlightStream from "./HighlightStream.svelte";
39
+ import plaintext from "./languages/plaintext.js";
40
+ import { loadLanguage } from "./load-language.js";
41
+
42
+ /**
43
+ * @param {string | undefined} lang
44
+ * @returns {Promise<import("./languages").LanguageType<string> | undefined>}
45
+ */
46
+ async function defaultResolveLanguage(lang) {
47
+ if (!lang) return undefined;
48
+ try {
49
+ return await loadLanguage(
50
+ /** @type {import("./languages").LanguageName} */ (lang),
51
+ );
52
+ } catch {
53
+ return undefined;
54
+ }
55
+ }
56
+
57
+ const dispatch = createEventDispatcher();
58
+ const splitter = createFenceSplitter();
59
+
60
+ let previousText = "";
61
+ /** @type {readonly import("./fence.d.ts").MarkdownSegment[]} */
62
+ let segments = splitter.segments();
63
+
64
+ // Fence ids already reported via the `fence` event -- an id is only ever
65
+ // seen once, even if the splitter later rebuilds the segment object (a
66
+ // regenerated buffer keeps the id per the splitter's contract).
67
+ /** @type {Set<number>} */
68
+ const seenFenceIds = new Set();
69
+
70
+ // Resolved languages by canonical name, plus in-flight names so a second
71
+ // fence sharing a language doesn't re-invoke `resolveLanguage`.
72
+ /** @type {Record<string, import("./languages").LanguageType<string>>} */
73
+ let resolvedLanguages = {};
74
+ /** @type {Set<string>} */
75
+ const pendingLanguages = new Set();
76
+
77
+ /** @param {string | undefined} lang */
78
+ function cacheKey(lang) {
79
+ return lang === undefined ? "\0" : lang;
80
+ }
81
+
82
+ /** @param {import("./fence.d.ts").FenceSegment} segment */
83
+ function ensureLanguage(segment) {
84
+ const key = cacheKey(segment.lang);
85
+ if (pendingLanguages.has(key)) return;
86
+ pendingLanguages.add(key);
87
+ Promise.resolve(resolveLanguage(segment.lang, segment))
88
+ .then((language) => {
89
+ resolvedLanguages = {
90
+ ...resolvedLanguages,
91
+ [key]: language ?? plaintext,
92
+ };
93
+ })
94
+ .catch(() => {
95
+ resolvedLanguages = { ...resolvedLanguages, [key]: plaintext };
96
+ });
97
+ }
98
+
99
+ /**
100
+ * `languages` is passed in so the template tracks the cache. A helper
101
+ * that only closed over `resolvedLanguages` would not re-run when a
102
+ * grammar finished loading (Svelte 3/4, and Svelte 5's `untrack` of
103
+ * helper bodies).
104
+ * @param {Record<string, import("./languages").LanguageType<string>>} languages
105
+ * @param {import("./fence.d.ts").FenceSegment} segment
106
+ */
107
+ function languageFor(languages, segment) {
108
+ return languages[cacheKey(segment.lang)] ?? plaintext;
109
+ }
110
+
111
+ // Feed the splitter, then re-read its (identity-stable) segment list.
112
+ $: {
113
+ if (text !== previousText) {
114
+ if (text.startsWith(previousText)) {
115
+ splitter.append(text.slice(previousText.length));
116
+ } else {
117
+ splitter.set(text);
118
+ }
119
+ previousText = text;
120
+ segments = splitter.segments();
121
+ }
122
+ }
123
+
124
+ $: for (const segment of segments) {
125
+ if (segment.kind !== "fence") continue;
126
+ if (!seenFenceIds.has(segment.id)) {
127
+ seenFenceIds.add(segment.id);
128
+ dispatch("fence", { id: segment.id, lang: segment.lang });
129
+ }
130
+ ensureLanguage(segment);
131
+ }
132
+
133
+ let doneDispatched = false;
134
+ $: if (done) {
135
+ if (!doneDispatched) {
136
+ doneDispatched = true;
137
+ dispatch("done");
138
+ }
139
+ } else {
140
+ doneDispatched = false;
141
+ }
142
+
143
+ // Only the trailing segment can be an open fence (the parser is still
144
+ // inside it), so caret placement never needs to scan the whole document.
145
+ $: lastSegment = segments[segments.length - 1];
146
+ $: lastOpenFenceId =
147
+ lastSegment !== undefined &&
148
+ lastSegment.kind === "fence" &&
149
+ lastSegment.open
150
+ ? lastSegment.id
151
+ : undefined;
152
+
153
+ $: lastFenceId = findLastFenceId(segments);
154
+
155
+ /** @param {readonly import("./fence.d.ts").MarkdownSegment[]} list */
156
+ function findLastFenceId(list) {
157
+ for (let i = list.length - 1; i >= 0; i -= 1) {
158
+ const segment = /** @type {import("./fence.d.ts").MarkdownSegment} */ (
159
+ list[i]
160
+ );
161
+ if (segment.kind === "fence") return segment.id;
162
+ }
163
+ return undefined;
164
+ }
165
+ </script>
166
+
167
+ <div class="shl-md" aria-busy={!done} {...$$restProps}>
168
+ {#each segments as segment (segment.id)}
169
+ {#if segment.kind === "text"}
170
+ <slot name="text" {segment}>
171
+ <div class="shl-md-text">{segment.text}</div>
172
+ </slot>
173
+ {:else}
174
+ <slot
175
+ name="fence"
176
+ {segment}
177
+ language={languageFor(resolvedLanguages, segment)}
178
+ >
179
+ <HighlightStream
180
+ code={segment.code}
181
+ language={languageFor(resolvedLanguages, segment)}
182
+ done={done || !segment.open}
183
+ caret={caret && segment.id === lastOpenFenceId}
184
+ {autoScroll}
185
+ doneText={segment.id === lastFenceId ? doneText : ""}
186
+ />
187
+ </slot>
188
+ {/if}
189
+ {/each}
190
+ </div>
191
+
192
+ <style>
193
+ .shl-md {
194
+ display: flex;
195
+ flex-direction: column;
196
+ gap: var(--md-gap, 1em);
197
+ }
198
+
199
+ .shl-md-text {
200
+ white-space: var(--md-text-white-space, pre-wrap);
201
+ }
202
+ </style>
@@ -0,0 +1,100 @@
1
+ import type { SvelteComponentTyped } from "svelte";
2
+ import type { HTMLAttributes } from "svelte/elements";
3
+ import type { FenceSegment, MarkdownSegment } from "./fence";
4
+ import type { LanguageType } from "./languages";
5
+
6
+ export type MarkdownStreamProps = HTMLAttributes<HTMLDivElement> & {
7
+ /**
8
+ * Growing Markdown buffer. On change, `splitter.append` is used when the
9
+ * new value starts with the previous one; otherwise the whole buffer is
10
+ * replaced via `splitter.set` (a regenerated reply, say).
11
+ * @default ""
12
+ */
13
+ text?: string;
14
+
15
+ /**
16
+ * Stream finished. Forwarded to every fence's `HighlightStream` as
17
+ * `done || !segment.open`, so a trailing open fence is treated as closed
18
+ * once the overall stream ends.
19
+ * @default false
20
+ */
21
+ done?: boolean;
22
+
23
+ /**
24
+ * Resolves a fence's language. The default dynamically imports the
25
+ * grammar via `loadLanguage`, falling back to plaintext while loading and
26
+ * whenever `lang` is `undefined`, unrecognized, or the returned promise
27
+ * rejects -- it never throws. Results are cached per canonical name for
28
+ * the component's lifetime.
29
+ * @default resolves via `loadLanguage`, falling back to plaintext
30
+ */
31
+ resolveLanguage?: (
32
+ lang: string | undefined,
33
+ segment: FenceSegment,
34
+ ) => LanguageType<string> | Promise<LanguageType<string>> | undefined;
35
+
36
+ /**
37
+ * Show a blinking caret at the end of the last open fence while streaming.
38
+ * @default true
39
+ */
40
+ caret?: boolean;
41
+
42
+ /**
43
+ * Keep each streaming fence scrolled to the bottom, unless the user has
44
+ * scrolled away from it.
45
+ * @default true
46
+ */
47
+ autoScroll?: boolean;
48
+
49
+ /**
50
+ * Announced by the last fence's visually-hidden live region once `done`
51
+ * becomes `true` -- every other fence gets `""` so completion is
52
+ * announced only once. Set to `""` to disable the announcement.
53
+ * @default "Code finished streaming"
54
+ */
55
+ doneText?: string;
56
+
57
+ /**
58
+ * Space between prose and fence segments.
59
+ * @default "1em"
60
+ */
61
+ "--md-gap"?: string;
62
+
63
+ /**
64
+ * `white-space` of the default prose block.
65
+ * @default "pre-wrap"
66
+ */
67
+ "--md-text-white-space"?: string;
68
+ };
69
+
70
+ export type MarkdownStreamEvents = {
71
+ /**
72
+ * Fires once, the first time a fence segment appears.
73
+ */
74
+ fence: CustomEvent<{
75
+ id: number;
76
+ lang: string | undefined;
77
+ }>;
78
+
79
+ /**
80
+ * Fires once when `done` becomes `true`.
81
+ */
82
+ done: CustomEvent<null>;
83
+ };
84
+
85
+ export type MarkdownStreamSlots = {
86
+ text: {
87
+ segment: MarkdownSegment & { kind: "text" };
88
+ };
89
+ fence: {
90
+ segment: FenceSegment;
91
+ /** The resolved language, or plaintext while loading/unknown. */
92
+ language: LanguageType<string>;
93
+ };
94
+ };
95
+
96
+ export default class MarkdownStream extends SvelteComponentTyped<
97
+ MarkdownStreamProps,
98
+ MarkdownStreamEvents,
99
+ MarkdownStreamSlots
100
+ > {}