@lincyaw/kernel 1.0.0-rc.2 → 1.0.0-rc.21
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.
- package/package.json +2 -1
- package/src/contracts/capture.ts +148 -0
- package/src/contracts/preview.ts +3 -0
- package/src/contracts/workspace.ts +2 -0
- package/src/contracts.ts +1 -0
- package/src/embed.ts +26 -0
- package/src/escape-html.ts +4 -0
- package/src/html.ts +1 -4
- package/src/index.ts +9 -4
- package/src/ir.ts +22 -0
- package/src/lower-myst.ts +3 -12
- package/src/myst-marks.ts +15 -0
- package/src/node/fonts.ts +6 -3
- package/src/node/index.ts +2 -0
- package/src/node/service-state.ts +52 -0
- package/src/preview-events.ts +3 -2
- package/src/preview-frame-connect.ts +1124 -0
- package/src/preview-frame.ts +32 -1119
- package/src/stale-module.ts +15 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lincyaw/kernel",
|
|
3
|
-
"version": "1.0.0-rc.
|
|
3
|
+
"version": "1.0.0-rc.21",
|
|
4
4
|
"description": "Presmium's shared kernel: the IR and plugin contracts, the service registry, anchors and checks",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
"ir"
|
|
16
16
|
],
|
|
17
17
|
"type": "module",
|
|
18
|
+
"sideEffects": false,
|
|
18
19
|
"engines": {
|
|
19
20
|
"node": ">=22.19"
|
|
20
21
|
},
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pictures of a document as its presentation shows it, taken by the workspace service in a headless browser: the rest
|
|
3
|
+
* frame of each step, or a moment into a step's animation, with the boxes of the elements an agent asks about. Agents
|
|
4
|
+
* (over MCP) check animations and layout with it instead of scripting a browser.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
/** At most this many pictures a request: each is one image in a tool result. */
|
|
8
|
+
export const CAPTURE_MAX_FRAMES = 12
|
|
9
|
+
/** At most this many boxes a picture reports for `measure`. */
|
|
10
|
+
export const CAPTURE_MAX_BOXES = 200
|
|
11
|
+
|
|
12
|
+
export interface SlideCaptureRequest {
|
|
13
|
+
/** The page (section) id, or its number from 1. */
|
|
14
|
+
section: string
|
|
15
|
+
/** The steps to show, from 0; every step of the page when omitted. */
|
|
16
|
+
steps?: number[]
|
|
17
|
+
/** Milliseconds into each step's animation; each step's rest frame (its final state) when omitted. */
|
|
18
|
+
at?: number[]
|
|
19
|
+
appearance?: 'light' | 'dark'
|
|
20
|
+
/** Device pixels per slide pixel. */
|
|
21
|
+
scale?: 1 | 2
|
|
22
|
+
/** A region of the slide, in slide pixels. */
|
|
23
|
+
clip?: { x: number, y: number, width: number, height: number }
|
|
24
|
+
/** A CSS selector: the boxes of the matching elements in the slide are reported, in slide pixels. */
|
|
25
|
+
measure?: string
|
|
26
|
+
/**
|
|
27
|
+
* How the presentation reaches each step: `direct` (default) draws it from its step and moment; `backward` shows the
|
|
28
|
+
* step after it first and goes back as a presenter does, with the page's own clock, to check that going back works.
|
|
29
|
+
*/
|
|
30
|
+
arrive?: 'direct' | 'backward'
|
|
31
|
+
/** Draw the presentation's captions over the slide (default true); false shows the whole slide, the narration being in `narration`. */
|
|
32
|
+
captions?: boolean
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export interface ReadingCaptureRequest {
|
|
36
|
+
/** The page (section) id, or its number from 1. */
|
|
37
|
+
section: string
|
|
38
|
+
/** The window's width in CSS pixels (default 1280; 390 for a phone). */
|
|
39
|
+
width?: number
|
|
40
|
+
appearance?: 'light' | 'dark'
|
|
41
|
+
/** Device pixels per CSS pixel. */
|
|
42
|
+
scale?: 1 | 2
|
|
43
|
+
/** A CSS selector: the boxes of the matching elements in the page's section are reported, in CSS pixels. */
|
|
44
|
+
measure?: string
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export interface CapturedReading {
|
|
48
|
+
section: string
|
|
49
|
+
/** The PNG file of the picture, in the service's state directory. */
|
|
50
|
+
file: string
|
|
51
|
+
/** The section's size in CSS pixels; the picture is cut at `CAPTURE_MAX_HEIGHT`. */
|
|
52
|
+
width: number
|
|
53
|
+
height: number
|
|
54
|
+
cut: boolean
|
|
55
|
+
boxes?: CapturedBox[]
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export interface ReadingCaptureResult {
|
|
59
|
+
document: string
|
|
60
|
+
width: number
|
|
61
|
+
frames: CapturedReading[]
|
|
62
|
+
problems: string[]
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** The tallest picture of a reading page's section, in CSS pixels. */
|
|
66
|
+
export const CAPTURE_MAX_HEIGHT = 8000
|
|
67
|
+
|
|
68
|
+
export interface CapturedBox {
|
|
69
|
+
x: number
|
|
70
|
+
y: number
|
|
71
|
+
width: number
|
|
72
|
+
height: number
|
|
73
|
+
visible: boolean
|
|
74
|
+
/** The start of the element's text. */
|
|
75
|
+
text: string
|
|
76
|
+
/** Its `id`, `class` and `data-*` attributes. */
|
|
77
|
+
attributes: Record<string, string>
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export interface CapturedSlide {
|
|
81
|
+
section: string
|
|
82
|
+
slide: number
|
|
83
|
+
step: number
|
|
84
|
+
/** Milliseconds into the step, or null for its rest frame. */
|
|
85
|
+
at: number | null
|
|
86
|
+
/** The step's narration (its script), as text: what the captions show. */
|
|
87
|
+
narration: string
|
|
88
|
+
/** The PNG file of the picture, in the service's state directory. */
|
|
89
|
+
file: string
|
|
90
|
+
width: number
|
|
91
|
+
height: number
|
|
92
|
+
boxes?: CapturedBox[]
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export interface SlideCaptureResult {
|
|
96
|
+
document: string
|
|
97
|
+
/** The slide's size in slide pixels. */
|
|
98
|
+
shape: { width: number, height: number }
|
|
99
|
+
frames: CapturedSlide[]
|
|
100
|
+
/** What failed in the page while it was drawn: component errors, page errors. */
|
|
101
|
+
problems: string[]
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
export interface OverviewCaptureRequest {
|
|
105
|
+
/** Each page's last step (default), or every step of every page. */
|
|
106
|
+
steps?: 'last' | 'all'
|
|
107
|
+
appearance?: 'light' | 'dark'
|
|
108
|
+
/** Thumbnails a row on a sheet (default 4). */
|
|
109
|
+
columns?: number
|
|
110
|
+
/** Draw the presentation's captions over the slides (default true). */
|
|
111
|
+
captions?: boolean
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
export interface OverviewCaptureResult {
|
|
115
|
+
document: string
|
|
116
|
+
/** The directory of the pictures, named so that they sort in reading order (`03-12-page.png`: page 3, step 12 from 0). */
|
|
117
|
+
dir: string
|
|
118
|
+
frames: { section: string, slide: number, step: number, file: string, narration: string }[]
|
|
119
|
+
/** `narration.md` beside the pictures: each picture's narration under its file name. */
|
|
120
|
+
narrationFile: string
|
|
121
|
+
/** Sheets of thumbnails, at most `CAPTURE_SHEET_SIZE` each, in order. */
|
|
122
|
+
sheets: string[]
|
|
123
|
+
problems: string[]
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/** Thumbnails on one overview sheet; and the most pictures an overview takes. */
|
|
127
|
+
export const CAPTURE_SHEET_SIZE = 20
|
|
128
|
+
export const CAPTURE_MAX_OVERVIEW = 400
|
|
129
|
+
|
|
130
|
+
export interface DocumentCapture {
|
|
131
|
+
/** The pictures, with their PNG bytes in the order of `frames`. */
|
|
132
|
+
slides(document: string, request: SlideCaptureRequest, signal?: AbortSignal): Promise<SlideCaptureResult & { images: Uint8Array[] }>
|
|
133
|
+
/** A page of the reading version (the web page), with its PNG bytes. */
|
|
134
|
+
reading(document: string, request: ReadingCaptureRequest, signal?: AbortSignal): Promise<ReadingCaptureResult & { images: Uint8Array[] }>
|
|
135
|
+
/** Every page's rest frames as the presentation shows them, as files and as sheets of thumbnails (the images). */
|
|
136
|
+
overview(document: string, request: OverviewCaptureRequest, signal?: AbortSignal): Promise<OverviewCaptureResult & { images: Uint8Array[] }>
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** The hook a viewer page opened with `?capture` installs, which the capturing browser drives. */
|
|
140
|
+
export interface CaptureHook {
|
|
141
|
+
/** A slide at a step: drawn at the moment `at` (its rest frame when omitted), or reached going back from the step after. */
|
|
142
|
+
show(position: { section: string, step: number, at?: number, arrive?: 'direct' | 'backward' }): Promise<{ problems: string[] }>
|
|
143
|
+
/** A section of the reading page, scrolled through so that its components load, at rest. */
|
|
144
|
+
read(section: string): Promise<{ problems: string[] }>
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
export const CAPTURE_HOOK = 'presmiumCapture'
|
|
148
|
+
export const CAPTURE_PARAM = 'capture'
|
package/src/contracts/preview.ts
CHANGED
|
@@ -10,6 +10,9 @@ export const PREVIEW_PARAM = 'presmium-preview'
|
|
|
10
10
|
/** The workbench's appearance when it loads a preview (`dark` or `light`), so that the page's first paint matches it. */
|
|
11
11
|
export const PREVIEW_APPEARANCE_PARAM = 'presmium-appearance'
|
|
12
12
|
|
|
13
|
+
/** `?captions=off` starts a presentation with its captions off (a reader turns them on again with the captions button). */
|
|
14
|
+
export const CAPTIONS_PARAM = 'captions'
|
|
15
|
+
|
|
13
16
|
export const PREVIEW_REVISION = 'presmiumRevision'
|
|
14
17
|
|
|
15
18
|
export const AUTHOR_MARKS_CLASS = 'pm-author-marks'
|
|
@@ -94,6 +94,8 @@ export interface DocumentSummary {
|
|
|
94
94
|
description?: string
|
|
95
95
|
lang?: string
|
|
96
96
|
tags?: string[]
|
|
97
|
+
/** Whether its metadata asks for a presentation (`renderers.slides`), which a site serves below its pages. */
|
|
98
|
+
slides?: boolean
|
|
97
99
|
}
|
|
98
100
|
|
|
99
101
|
/** @experimental The workspace service's answer to `documents`. */
|
package/src/contracts.ts
CHANGED
package/src/embed.ts
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What a page tells the page that embeds it in a frame, as `postMessage` to its parent: whether its current slide is
|
|
3
|
+
* drawn (no component is still loading) and the state of its lecture. An embedding page (a site's home page playing a
|
|
4
|
+
* document's presentation) keeps its own cover until `drawn`, and offers Play when the lecture is `waiting`.
|
|
5
|
+
*/
|
|
6
|
+
export const EMBED_MESSAGE = 'presmium:state'
|
|
7
|
+
|
|
8
|
+
export type EmbeddedLecture = 'loading' | 'waiting' | 'playing' | 'paused' | 'failed'
|
|
9
|
+
|
|
10
|
+
export interface EmbedState {
|
|
11
|
+
type: typeof EMBED_MESSAGE
|
|
12
|
+
drawn: boolean
|
|
13
|
+
section?: string
|
|
14
|
+
step?: number
|
|
15
|
+
/** Absent when the page plays no lecture. `waiting`: the browser refused autoplay; the reader's Play starts it. */
|
|
16
|
+
lecture?: EmbeddedLecture
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
let last: EmbedState = { type: EMBED_MESSAGE, drawn: false }
|
|
20
|
+
|
|
21
|
+
/** Sends the page's state, merged with what was sent before, to the embedding page; nothing when not in a frame. */
|
|
22
|
+
export function notifyEmbedder(change: Partial<Omit<EmbedState, 'type'>>): void {
|
|
23
|
+
if (typeof window === 'undefined' || window.parent === window) return
|
|
24
|
+
last = { ...last, ...change }
|
|
25
|
+
window.parent.postMessage(last, '*')
|
|
26
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
/** Text as it reads in HTML, in an element or an attribute's value; apart from `html.ts`, so that escaping loads no HTML parser. */
|
|
2
|
+
export function escapeHtml(text: string): string {
|
|
3
|
+
return text.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"')
|
|
4
|
+
}
|
package/src/html.ts
CHANGED
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
import { parseFragment } from 'parse5'
|
|
2
2
|
import type { DefaultTreeAdapterMap } from 'parse5'
|
|
3
|
-
|
|
4
|
-
export function escapeHtml(text: string): string {
|
|
5
|
-
return text.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"')
|
|
6
|
-
}
|
|
3
|
+
import { escapeHtml } from './escape-html.ts'
|
|
7
4
|
|
|
8
5
|
export interface HtmlAttribute {
|
|
9
6
|
name: string
|
package/src/index.ts
CHANGED
|
@@ -25,7 +25,8 @@ export { errorMessage, isRecord, PreviewPreparing } from './errors.ts'
|
|
|
25
25
|
export { createEventBus } from './events.ts'
|
|
26
26
|
export { CREDENTIAL_VARIABLE, environmentExecutor, failedRun, languageId } from './execution.ts'
|
|
27
27
|
export { gitConfigArgs, gitEnvironment } from './git.ts'
|
|
28
|
-
export { escapeHtml
|
|
28
|
+
export { escapeHtml } from './escape-html.ts'
|
|
29
|
+
export { htmlAttributes, mapHtmlUrls, URL_ATTRIBUTES } from './html.ts'
|
|
29
30
|
export type { HtmlAttribute } from './html.ts'
|
|
30
31
|
export { hostName, localRequestRefusal } from './requests.ts'
|
|
31
32
|
export type { RequestHeaders } from './requests.ts'
|
|
@@ -39,9 +40,13 @@ export type { KernelOptions } from './kernel.ts'
|
|
|
39
40
|
export { deckLocale, localeOf } from './locale.ts'
|
|
40
41
|
export { ANCHOR_LOCK_PATH, AnchorLock } from './lock.ts'
|
|
41
42
|
export { prefixedLogger } from './logging.ts'
|
|
42
|
-
export { lowerMyst
|
|
43
|
+
export { lowerMyst } from './lower-myst.ts'
|
|
43
44
|
export type { LinkedType, LoweredMarkdown, LowerOptions } from './lower-myst.ts'
|
|
44
|
-
export {
|
|
45
|
+
export { isPreviewActive, isPreviewEmbedded, previewAppearance, reportPreview, siteFrameAncestors } from './preview-frame.ts'
|
|
46
|
+
export { connectPreviewFrame } from './preview-frame-connect.ts'
|
|
47
|
+
export { reportStaleModule, STALE_MODULE_EVENT, STALE_MODULE_PATTERN } from './stale-module.ts'
|
|
48
|
+
export { EMBED_MESSAGE, notifyEmbedder } from './embed.ts'
|
|
49
|
+
export type { EmbeddedLecture, EmbedState } from './embed.ts'
|
|
45
50
|
export { keyBelongsToTarget, watchFocusSource } from './keyboard.ts'
|
|
46
51
|
export type { PreviewFrame, PreviewPage, PreviewProblem, PreviewTextEdit, PreviewTextHandle } from './preview-frame.ts'
|
|
47
52
|
export { previewEditBinding } from './preview-edit.ts'
|
|
@@ -65,7 +70,7 @@ export type { StepKeys } from './step-keys.ts'
|
|
|
65
70
|
export { parseDuration } from './durations.ts'
|
|
66
71
|
export { stepStateAt } from './steps.ts'
|
|
67
72
|
export { ABSOLUTE_URL, NON_FILE_URL, urlSlug } from './urls.ts'
|
|
68
|
-
export { isButton } from './
|
|
73
|
+
export { isButton, roleMark } from './myst-marks.ts'
|
|
69
74
|
export { componentProps, findComponentRenderer, hasRendererExtension, WEB_RENDERER_PACKAGE, withPublishedAssets } from './renderer-components.ts'
|
|
70
75
|
export { htmlAsText, isProseRun } from './run-outputs.ts'
|
|
71
76
|
export { safeDecodeURIComponent } from './uri-decoding.ts'
|
package/src/ir.ts
CHANGED
|
@@ -318,6 +318,11 @@ export interface Renderer {
|
|
|
318
318
|
dev?(doc: IRDocument, ctx: RenderContext): Promise<RenderDevServer>
|
|
319
319
|
buildSite?(site: SiteSpec, ctx: RenderContext): Promise<RenderOutput>
|
|
320
320
|
devSite?(site: SiteSpec, ctx: RenderContext, compile: (dir: string) => Promise<IRDocument>): Promise<SiteDevServer>
|
|
321
|
+
/**
|
|
322
|
+
* What would fail in its output of the whole document (every form's blocks), found ahead of a build: run with the
|
|
323
|
+
* document's checks (`presmium check`). The web renderer's: the document's own code that does not bundle.
|
|
324
|
+
*/
|
|
325
|
+
check?(doc: IRDocument, ctx: RenderContext): Promise<Finding[]>
|
|
321
326
|
}
|
|
322
327
|
|
|
323
328
|
export interface SiteDocument {
|
|
@@ -326,11 +331,23 @@ export interface SiteDocument {
|
|
|
326
331
|
description?: string
|
|
327
332
|
lang?: string
|
|
328
333
|
tags?: string[]
|
|
334
|
+
/** Whether it has a presentation, before its IR is compiled (`DocumentSummary.slides`). */
|
|
335
|
+
slides?: boolean
|
|
329
336
|
doc?: IRDocument
|
|
330
337
|
translations?: { lang: string, doc: IRDocument }[]
|
|
331
338
|
nodeVitePlugins?: NodeVitePlugin[]
|
|
332
339
|
}
|
|
333
340
|
|
|
341
|
+
/**
|
|
342
|
+
* A built site keeps its viewer apps below its path, each at `<APP_DIR>/<key>/` by its content. A presentation built as
|
|
343
|
+
* part of a site (renderer option `appBase`, the site's path) names its app there, so the site's pages and all its
|
|
344
|
+
* presentations load one app.
|
|
345
|
+
*/
|
|
346
|
+
export const APP_DIR = '_app'
|
|
347
|
+
|
|
348
|
+
/** A site serves a document's presentation (`renderers.slides`) below the document's pages, at `<document>/<SLIDES_DIR>/`. */
|
|
349
|
+
export const SLIDES_DIR = 'slides'
|
|
350
|
+
|
|
334
351
|
export interface SiteSpec {
|
|
335
352
|
title: string
|
|
336
353
|
documents: SiteDocument[]
|
|
@@ -352,6 +369,11 @@ export interface SiteDevServer {
|
|
|
352
369
|
* With `wait`, a build still running after the wait rejects with `PreviewPreparing`; a failed build with its reason.
|
|
353
370
|
*/
|
|
354
371
|
app?(dir: string, wait?: boolean): Promise<string | undefined>
|
|
372
|
+
/**
|
|
373
|
+
* The files of document `dir`'s own code that the bundle its pages load now leaves out, since they do not bundle:
|
|
374
|
+
* each module that imports one fails alone when the document shows it (`app` rejects when the whole does not bundle).
|
|
375
|
+
*/
|
|
376
|
+
codeFindings?(dir: string): Finding[]
|
|
355
377
|
close(): Promise<void>
|
|
356
378
|
}
|
|
357
379
|
|
package/src/lower-myst.ts
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import { escapeHtml as escape
|
|
1
|
+
import { escapeHtml as escape } from './escape-html.ts'
|
|
2
|
+
import { mapHtmlUrls } from './html.ts'
|
|
3
|
+
import { isButton, roleMark } from './myst-marks.ts'
|
|
2
4
|
import type { MdastNode } from './ir.ts'
|
|
3
5
|
|
|
4
6
|
export type LinkedType = 'image' | 'link' | 'definition'
|
|
@@ -198,11 +200,6 @@ function cardsAs(options: LowerOptions): 'element' | 'headings' {
|
|
|
198
200
|
return options.cards ?? (options.iframes === 'element' ? 'element' : 'headings')
|
|
199
201
|
}
|
|
200
202
|
|
|
201
|
-
/** Whether a MyST node has the class `button`, which renders a link or span as a button. */
|
|
202
|
-
export function isButton(node: MdastNode): boolean {
|
|
203
|
-
return typeof node.class === 'string' && node.class.split(/\s+/).includes('button')
|
|
204
|
-
}
|
|
205
|
-
|
|
206
203
|
function layout(node: MdastNode, ctx: Lowering): MdastNode[] {
|
|
207
204
|
const all = (nodes: MdastNode[] = []) => nodes.flatMap(child => lower(child, ctx))
|
|
208
205
|
const element = cardsAs(ctx.options) === 'element'
|
|
@@ -248,12 +245,6 @@ function layout(node: MdastNode, ctx: Lowering): MdastNode[] {
|
|
|
248
245
|
return all(items)
|
|
249
246
|
}
|
|
250
247
|
|
|
251
|
-
export function roleMark(node: MdastNode): string {
|
|
252
|
-
const options = typeof node.options === 'object' && node.options !== null ? node.options as Record<string, unknown> : {}
|
|
253
|
-
const value = typeof options.value === 'string' ? options.value.trim() : ''
|
|
254
|
-
return `〔${String(node.name ?? '')}${value ? ` ${value}` : ''}〕`
|
|
255
|
-
}
|
|
256
|
-
|
|
257
248
|
function footnoteNumber(node: MdastNode): string {
|
|
258
249
|
return String(node.enumerator ?? node.label ?? node.identifier)
|
|
259
250
|
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { MdastNode } from './ir.ts'
|
|
2
|
+
|
|
3
|
+
// What a viewer reads from MyST nodes as they are, apart from their lowering (`lower-myst.ts`), which rewrites HTML.
|
|
4
|
+
|
|
5
|
+
/** Whether a MyST node has the class `button`, which renders a link or span as a button. */
|
|
6
|
+
export function isButton(node: MdastNode): boolean {
|
|
7
|
+
return typeof node.class === 'string' && node.class.split(/\s+/).includes('button')
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/** The mark a role without content shows: its name and value. */
|
|
11
|
+
export function roleMark(node: MdastNode): string {
|
|
12
|
+
const options = typeof node.options === 'object' && node.options !== null ? node.options as Record<string, unknown> : {}
|
|
13
|
+
const value = typeof options.value === 'string' ? options.value.trim() : ''
|
|
14
|
+
return `〔${String(node.name ?? '')}${value ? ` ${value}` : ''}〕`
|
|
15
|
+
}
|
package/src/node/fonts.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { readFileSync } from 'node:fs'
|
|
1
|
+
import { readFileSync, realpathSync } from 'node:fs'
|
|
2
2
|
import { createRequire, findPackageJSON } from 'node:module'
|
|
3
3
|
|
|
4
4
|
export const FONT_LICENSE = 'presmium/fonts/LICENSE'
|
|
@@ -10,8 +10,11 @@ const FONT_COPYRIGHTS: Record<string, string> = {
|
|
|
10
10
|
}
|
|
11
11
|
|
|
12
12
|
export function fontLicense(from: string | URL): string {
|
|
13
|
-
const
|
|
14
|
-
if (!
|
|
13
|
+
const found = findPackageJSON('@lincyaw/host', from)
|
|
14
|
+
if (!found) throw new Error('@lincyaw/host is not installed')
|
|
15
|
+
// findPackageJSON keeps the symlinked path; the fonts are host's own dependencies, which an isolated store (pnpm's
|
|
16
|
+
// global store) puts beside the real package, so they are resolved from there.
|
|
17
|
+
const manifest = realpathSync(found)
|
|
15
18
|
const { dependencies = {} } = JSON.parse(readFileSync(manifest, 'utf8')) as { dependencies?: Record<string, string> }
|
|
16
19
|
const require = createRequire(manifest)
|
|
17
20
|
const files = Object.keys(dependencies).filter(name => name.startsWith('@fontsource/')).sort().map((name) => {
|
package/src/node/index.ts
CHANGED
|
@@ -27,3 +27,5 @@ export { validateProjectPlan, validateProjectApply } from './projects.ts'
|
|
|
27
27
|
export { validateDocumentWorkspaceImageInspect, validateDocumentWorkspaceImageImport } from './document-image.ts'
|
|
28
28
|
export { systemLocale } from './locale.ts'
|
|
29
29
|
export { OperatorSpeechSettings, operatorSpeechSecrets, SpeechSettingsError } from './operator-speech.ts'
|
|
30
|
+
export { devStateFile, readServiceState, removeServiceState, serveStateDir } from './service-state.ts'
|
|
31
|
+
export type { ServiceState } from './service-state.ts'
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto'
|
|
2
|
+
import { readFileSync, rmSync } from 'node:fs'
|
|
3
|
+
import { homedir } from 'node:os'
|
|
4
|
+
import { join } from 'node:path'
|
|
5
|
+
import { isRecord } from '../errors.ts'
|
|
6
|
+
|
|
7
|
+
/** What a running Presmium server records for local clients: its address, its MCP endpoint and token, its process. */
|
|
8
|
+
export interface ServiceState {
|
|
9
|
+
url: string
|
|
10
|
+
mcp: string
|
|
11
|
+
token: string
|
|
12
|
+
pid: number
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/** The state directory of the workspace service (`presmium serve`, and the one `presmium studio` starts) of `root`. */
|
|
16
|
+
export function serveStateDir(root: string, env: NodeJS.ProcessEnv = process.env): string {
|
|
17
|
+
const base = env.XDG_CACHE_HOME || join(homedir(), '.cache')
|
|
18
|
+
return join(base, 'presmium', 'serve', createHash('sha256').update(root).digest('hex').slice(0, 16))
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** The state file `presmium dev` writes beside the document it previews. */
|
|
22
|
+
export function devStateFile(deckDir: string): string {
|
|
23
|
+
return join(deckDir, '.presmium', 'server.json')
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
const alive = (pid: number): boolean => {
|
|
27
|
+
try {
|
|
28
|
+
process.kill(pid, 0)
|
|
29
|
+
return true
|
|
30
|
+
} catch (error) {
|
|
31
|
+
return (error as NodeJS.ErrnoException).code === 'EPERM'
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** The state of the server that wrote `file`, while that process runs. */
|
|
36
|
+
export function readServiceState(file: string): ServiceState | undefined {
|
|
37
|
+
try {
|
|
38
|
+
const state: unknown = JSON.parse(readFileSync(file, 'utf8'))
|
|
39
|
+
if (!isRecord(state) || typeof state.url !== 'string' || typeof state.mcp !== 'string' || typeof state.token !== 'string' || typeof state.pid !== 'number') return undefined
|
|
40
|
+
return alive(state.pid) ? { url: state.url, mcp: state.mcp, token: state.token, pid: state.pid } : undefined
|
|
41
|
+
} catch {
|
|
42
|
+
return undefined
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** Removes `file` when it is still this process's: a server that stopped leaves no address behind. */
|
|
47
|
+
export function removeServiceState(file: string, pid = process.pid): void {
|
|
48
|
+
try {
|
|
49
|
+
const state: unknown = JSON.parse(readFileSync(file, 'utf8'))
|
|
50
|
+
if (isRecord(state) && state.pid === pid) rmSync(file, { force: true })
|
|
51
|
+
} catch {}
|
|
52
|
+
}
|
package/src/preview-events.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { PREVIEW_EVENTS_PARAM, previewEnvelope } from './contracts/preview.ts'
|
|
2
2
|
import type { PreviewCommand, PreviewEventSubscription, PreviewEventTarget, PreviewEventMessage } from './contracts/preview.ts'
|
|
3
|
-
import { previewNonce } from './preview-frame.ts'
|
|
3
|
+
import { parentOrigins, previewNonce } from './preview-frame.ts'
|
|
4
4
|
|
|
5
5
|
/** Uses the existing preview-ready handshake, origin fence and nonce; never opens a network connection. */
|
|
6
6
|
export interface PreviewEvents {
|
|
@@ -17,8 +17,9 @@ export function createPreviewEvents(origins: readonly string[], document: string
|
|
|
17
17
|
const connection = crypto.randomUUID()
|
|
18
18
|
const readers = new Map<string, { target: PreviewEventTarget, received(message: PreviewEventMessage): void }>()
|
|
19
19
|
let ready = false, stopped = false, parked = false
|
|
20
|
+
const targets = parentOrigins(origins)
|
|
20
21
|
const post = (message: Parameters<typeof previewEnvelope>[1]) => {
|
|
21
|
-
if (!stopped) for (const origin of
|
|
22
|
+
if (!stopped) for (const origin of targets) window.parent.postMessage(previewEnvelope(nonce, message), origin)
|
|
22
23
|
}
|
|
23
24
|
const subscribe = (id: string, target: PreviewEventTarget) => post({ type: 'events-subscribe', connection, id, target })
|
|
24
25
|
const park = () => {
|