@markii/host 0.0.0-stage → 0.17.0-next.2

package/dist/host/run-diagnostics.js

@@ -0,0 +1,43 @@
+/**
+ * The lines a host's diagnostics surface gets for one run's script
+ * failures (GitHub issue #37), moved here from
+ * `apps/vscode/src/run-diagnostics.ts` so Obsidian gains the same
+ * behavior instead of writing its own copy (it previously wrote each
+ * failure to its console ad hoc; VS Code showed them only as value-marker
+ * tooltips and the run marker, which a hidden or collapsed marker can
+ * bury). This is the "second home" AGENTS.md's "clean is not silent" rule
+ * requires: one line per failed script, with its name, its failure kind,
+ * and the same short reason the tooltip carries. No failures, no lines:
+ * the surface stays quiet on a clean run.
+ */
+export function formatRunFailureLines(failures) {
+    return failures.map((failure) => `${failure.name} (${failure.kind}): ${failure.message}`);
+}
+/**
+ * Every diagnostics line one completed run owes the host's surface, in
+ * the order they are written: a header and one indented line per failed
+ * script (the "second home" of each failure, `formatRunFailureLines`),
+ * then a header and the lines of any net-declaration mismatch. A clean
+ * run with agreeing declarations returns no lines, so an empty surface
+ * still means nothing went wrong.
+ */
+export function runDiagnosticLines(trigger, result) {
+    const lines = [];
+    const failureLines = formatRunFailureLines(result.failureDetails);
+    if (failureLines.length > 0) {
+        lines.push(`${trigger} run finished with ${String(failureLines.length)} script failure(s):`);
+        for (const line of failureLines)
+            lines.push(`  ${line}`);
+    }
+    if (result.netDeclarationDiagnostics.length > 0) {
+        lines.push(`${trigger} run: net declaration mismatch:`);
+        for (const line of result.netDeclarationDiagnostics) {
+            lines.push(`  ${line}`);
+        }
+    }
+    return lines;
+}
+/** The one line a run that threw (rather than returning failures) owes the diagnostics surface. */
+export function runCrashDiagnosticLine(trigger, detail) {
+    return `${trigger} run failed before it could report: ${detail}`;
+}

package/dist/host/script-execution.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The device-level script-execution switch and every sentence it can
+ * produce, merged from `apps/vscode/src/script-execution.ts` and
+ * `apps/obsidian/src/script-execution.ts` (survey finding A4: same file
+ * name, same four exports, doc comments sharing the same "WHAT IT IS /
+ * WHY DEVICE-LOCAL / WHY THE WORDING LIVES HERE" structure, differing
+ * only in a handful of words).
+ *
+ * WHAT IT IS. A single off switch for the Run path. When it is on, no
+ * trigger runs a note's scripts: not a manual run press, not run-on-open,
+ * not the scheduled-refresh timer. It sits on top of the existing
+ * guarantees rather than replacing any of them: the tier gate, the grant
+ * model, and the isolate are unchanged, and turning it on never touches a
+ * stored grant. Turning it back off leaves the same grants in place, so
+ * nothing is silently re-authorized either.
+ *
+ * WHY DEVICE-LOCAL. It decides whether code runs, so every host persists
+ * it outside anything that syncs or travels with a shared file: never
+ * VS Code's workspace-shared settings, never Obsidian's vault-synced
+ * `saveData`. Each app's own storage-boundary test is the executable half
+ * of that rule.
+ *
+ * WHY THE WORDING LIVES HERE. The files that wire this switch to a real
+ * UI (`preview-panel.ts`, `view.tsx`, `main.ts`) import their host's
+ * platform module and are therefore not unit-testable, so every
+ * user-visible string and every decision about which surface a blocked
+ * trigger reaches lives in this plain, host-labeled module instead.
+ *
+ * Pure and dependency-free: re-exported from `../browser.ts` as well as
+ * `../index.ts`.
+ */
+import type { RunTrigger } from '@markii/runtime';
+import type { HostLabels } from './adapter.js';
+/**
+ * What a blocked MANUAL run says. Two short sentences: what happened, and
+ * where to change it. The reason is the whole message, so nothing is
+ * hidden behind a diagnostics lookup for the one trigger a user is
+ * actively watching.
+ */
+export declare function scriptsDisabledNoticeText(labels: HostLabels): string;
+/** What the toggle command says once script execution is off. */
+export declare function scriptsDisabledConfirmationText(labels: HostLabels): string;
+/** What the toggle command says once script execution is on again. Says what did NOT change, since the honest answer to "did this re-grant anything" is no. */
+export declare function scriptsEnabledConfirmationText(labels: HostLabels): string;
+/**
+ * The notice a blocked run shows, or `undefined` for a trigger that shows
+ * none.
+ *
+ * Only `'manual'` gets a popup or notice. An `'auto'` run happens on every
+ * preview open and a `'scheduled'` one happens on a timer, so notifying
+ * for those would be a drip of identical notices reporting a state the
+ * user set themselves. They are not silent, though:
+ * `scriptsDisabledDiagnosticLine` below writes every blocked trigger to
+ * this host's designated diagnostics surface, so "why did my dashboard
+ * stop refreshing" has an answer that does not require developer tools.
+ */
+export declare function scriptsDisabledNotice(trigger: RunTrigger, labels: HostLabels): string | undefined;
+/**
+ * The diagnostics-surface line for one blocked run, whatever its trigger.
+ * A blocked `'scheduled'` run also says that the preview's refresh timer
+ * was stopped: leaving a timer ticking against a closed door would write
+ * this same line every interval for as long as the preview stayed open.
+ *
+ * Names this host's own setting when it has one (`labels.settingName`),
+ * so the same sentence still reads correctly from any host's diagnostics
+ * surface while telling a VS Code user exactly which setting to flip back.
+ * Any sink-specific prefix, such as a `[markii]` console tag, is the
+ * adapter's own `diagnostics(line)` call's job to add, never baked in here.
+ */
+export declare function scriptsDisabledDiagnosticLine(trigger: RunTrigger, labels: HostLabels): string;
+/** The diagnostics-surface line for a preview that opens with a refresh interval configured but script execution off, so the timer is never started. */
+export declare function scheduledRefreshNotStartedLine(labels: HostLabels): string;

package/dist/host/script-execution.js

@@ -0,0 +1,68 @@
+/**
+ * What a blocked MANUAL run says. Two short sentences: what happened, and
+ * where to change it. The reason is the whole message, so nothing is
+ * hidden behind a diagnostics lookup for the one trigger a user is
+ * actively watching.
+ */
+export function scriptsDisabledNoticeText(labels) {
+    return `Markii: script execution is off on ${labels.deviceNoun}. Turn it on in the Markii settings to run this note.`;
+}
+/** What the toggle command says once script execution is off. */
+export function scriptsDisabledConfirmationText(labels) {
+    return `Markii: script execution turned OFF on ${labels.deviceNoun}. No note runs its scripts until you turn it back on.`;
+}
+/** What the toggle command says once script execution is on again. Says what did NOT change, since the honest answer to "did this re-grant anything" is no. */
+export function scriptsEnabledConfirmationText(labels) {
+    return `Markii: script execution turned ON for ${labels.deviceNoun}. Your existing grants are unchanged, so a note still prompts for any host it has not been granted.`;
+}
+/**
+ * The notice a blocked run shows, or `undefined` for a trigger that shows
+ * none.
+ *
+ * Only `'manual'` gets a popup or notice. An `'auto'` run happens on every
+ * preview open and a `'scheduled'` one happens on a timer, so notifying
+ * for those would be a drip of identical notices reporting a state the
+ * user set themselves. They are not silent, though:
+ * `scriptsDisabledDiagnosticLine` below writes every blocked trigger to
+ * this host's designated diagnostics surface, so "why did my dashboard
+ * stop refreshing" has an answer that does not require developer tools.
+ */
+export function scriptsDisabledNotice(trigger, labels) {
+    return trigger === 'manual' ? scriptsDisabledNoticeText(labels) : undefined;
+}
+/**
+ * The clause naming why script execution is off, with the exact setting a
+ * user would toggle when this host has one (`labels.settingName`) — this
+ * is the diagnostics surface, the FULL-DETAIL home for a failure
+ * (AGENTS.md: "could a user, without opening developer tools ... discover
+ * that this failed and why?"), so it names the switch, not just the
+ * state. A host with no single named setting (a command or toggle
+ * instead) gets the plain sentence.
+ */
+function scriptExecutionOffClause(labels) {
+    return labels.settingName === undefined
+        ? `script execution is off on ${labels.deviceNoun}`
+        : `script execution is off on ${labels.deviceNoun} (${labels.settingName})`;
+}
+/**
+ * The diagnostics-surface line for one blocked run, whatever its trigger.
+ * A blocked `'scheduled'` run also says that the preview's refresh timer
+ * was stopped: leaving a timer ticking against a closed door would write
+ * this same line every interval for as long as the preview stayed open.
+ *
+ * Names this host's own setting when it has one (`labels.settingName`),
+ * so the same sentence still reads correctly from any host's diagnostics
+ * surface while telling a VS Code user exactly which setting to flip back.
+ * Any sink-specific prefix, such as a `[markii]` console tag, is the
+ * adapter's own `diagnostics(line)` call's job to add, never baked in here.
+ */
+export function scriptsDisabledDiagnosticLine(trigger, labels) {
+    const blocked = `run (${trigger}) blocked: ${scriptExecutionOffClause(labels)}.`;
+    return trigger === 'scheduled'
+        ? `${blocked} This preview's scheduled refresh was stopped; reopen the preview to resume it.`
+        : blocked;
+}
+/** The diagnostics-surface line for a preview that opens with a refresh interval configured but script execution off, so the timer is never started. */
+export function scheduledRefreshNotStartedLine(labels) {
+    return `scheduled refresh not started: ${scriptExecutionOffClause(labels)}.`;
+}

package/dist/host/terminal-packs.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The host-neutral half of loading TERMINAL packs (`terminal.js`, the
+ * prebuilt terminal registration module beside `webview.js`). A host that
+ * runs the terminal engine (`@markii/ansi`, which this package never
+ * depends on) calls `createMarkiiHost`'s `loadTerminalPacks`, which
+ * discovers the authorized packs and reads each one's `terminal.js` text
+ * through this module; the host then hands the text to the engine's own
+ * `loadTerminalPackScript`. Everything here is the one home of the wording
+ * for the failures in between (docs/integration.md's "clean is not silent":
+ * a failure reaches the diagnostics surface and the note shows the pack's
+ * components as a failed pack).
+ *
+ * SECURITY: a terminal pack runs inside the host's own process with that
+ * process's full privileges. Nothing here widens who may reach it: the
+ * caller names the packs, and `HostPackSource.authorizedFolders()` is the
+ * only way a folder becomes a candidate (never a note, a bundle, the
+ * working directory, or an environment variable).
+ */
+import type { DiscoveredPack } from '../packs/discover.js';
+import type { HostAdapter } from './adapter.js';
+/** One pack's `terminal.js` text, ready for the terminal engine's loader. */
+export interface TerminalPackScript {
+    readonly namespace: string;
+    readonly folder: string;
+    readonly text: string;
+}
+export interface ReadTerminalScriptsResult {
+    readonly scripts: readonly TerminalPackScript[];
+    /** One line per pack that names `ansi` sources but whose `terminal.js` could not be read. */
+    readonly problems: readonly string[];
+}
+/** Whether a discovered pack names at least one terminal (`ansi`) source. */
+export declare function packHasTerminalViews(pack: DiscoveredPack): boolean;
+export declare function terminalScriptMissingLine(namespace: string): string;
+export declare function terminalScriptUnreadableLine(namespace: string, reason: string): string;
+export declare function terminalScriptRejectedLine(namespace: string, reason: string): string;
+export declare function terminalScriptNamespaceMismatchLine(namespace: string, claimed: string): string;
+/** Reads each terminal-capable pack's `terminal.js`. Never throws. */
+export declare function readTerminalPackScripts(adapter: Pick<HostAdapter, 'exists' | 'readFile'>, packs: readonly DiscoveredPack[]): Promise<ReadTerminalScriptsResult>;

package/dist/host/terminal-packs.js

@@ -0,0 +1,51 @@
+import { prebuiltTerminalScriptPathFor } from '../packs/prebuilt.js';
+/** Whether a discovered pack names at least one terminal (`ansi`) source. */
+export function packHasTerminalViews(pack) {
+    return Object.keys(pack.componentPathsByEngine?.['ansi'] ?? {}).length > 0;
+}
+export function terminalScriptMissingLine(namespace) {
+    return `Pack "${namespace}" names terminal views but ships no terminal.js; its components read as a failed pack in the note.`;
+}
+export function terminalScriptUnreadableLine(namespace, reason) {
+    return `Pack "${namespace}" has a terminal.js that could not be read (${reason}); its components read as a failed pack in the note.`;
+}
+export function terminalScriptRejectedLine(namespace, reason) {
+    return `Pack "${namespace}" was not loaded: ${reason}. Its components read as a failed pack in the note.`;
+}
+export function terminalScriptNamespaceMismatchLine(namespace, claimed) {
+    return `Pack "${namespace}" was not loaded: its terminal.js registers the namespace "${claimed}", which does not match its pack.json. Its components read as a failed pack in the note.`;
+}
+/** Reads each terminal-capable pack's `terminal.js`. Never throws. */
+export async function readTerminalPackScripts(adapter, packs) {
+    const scripts = [];
+    const problems = [];
+    for (const pack of packs) {
+        if (!packHasTerminalViews(pack))
+            continue;
+        const namespace = pack.manifest.name;
+        const scriptPath = prebuiltTerminalScriptPathFor(pack.folder);
+        let present;
+        try {
+            present = await adapter.exists(scriptPath);
+        }
+        catch {
+            present = false;
+        }
+        if (!present) {
+            problems.push(terminalScriptMissingLine(namespace));
+            continue;
+        }
+        try {
+            const bytes = await adapter.readFile(scriptPath);
+            scripts.push({
+                namespace,
+                folder: pack.folder,
+                text: new TextDecoder().decode(bytes),
+            });
+        }
+        catch (err) {
+            problems.push(terminalScriptUnreadableLine(namespace, err instanceof Error ? err.message : String(err)));
+        }
+    }
+    return { scripts, problems };
+}

package/dist/html-engine.d.ts

@@ -0,0 +1,2 @@
+import type { HtmlExportEngine } from './export/note-export.js';
+export declare function createHtmlExportEngine(): HtmlExportEngine;

package/dist/html-engine.js

@@ -0,0 +1,29 @@
+/**
+ * The `@markii/html`-backed `HtmlExportEngine`. Kept out of the main entry
+ * (it is the one module that carries the static HTML renderer); a host that
+ * exports HTML builds it here and hands it to `createMarkiiHost`'s
+ * `htmlEngine` option or to `buildNoteExport`. Reached through
+ * `@markii/host/node`.
+ */
+import { escapeHtml, exportHtmlDocument, renderMarkToHtml } from '@markii/html';
+import { defaultHtmlRegistry } from '@markii/html/components';
+export function createHtmlExportEngine() {
+    return {
+        renderBody: (text, store, diagnostics) => renderMarkToHtml(text, defaultHtmlRegistry, store, undefined, {
+            ...(diagnostics.unavailableComponents !== undefined
+                ? { unavailableComponents: diagnostics.unavailableComponents }
+                : {}),
+            ...(diagnostics.onDiagnostic !== undefined
+                ? { onDiagnostic: diagnostics.onDiagnostic }
+                : {}),
+        }),
+        composeDocument: (bodyHtml, options) => exportHtmlDocument(bodyHtml, {
+            title: options.title,
+            extraCss: options.extraCss,
+            ...(options.docClassName !== undefined
+                ? { docClassName: options.docClassName }
+                : {}),
+        }),
+        escapeHtml,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+export type { ValuesFailure } from './values-failure.js';
+export { mergeArrivingValue } from './values-merge.js';
+export type { RunJob, RunResult, RunFailure, RunProgress, SpawnRunOptions, SpawnRunRequest, } from './run/run-host.js';
+export { isRunProgress } from './run/run-progress.js';
+export { spawnRun } from './run/run-host.js';
+export type { IsolateSpawner, RunIsolate, SpawnIsolateOptions, } from './run/isolate.js';
+export { createBrowserIsolate } from './run/browser-isolate.js';
+export type { BrowserIsolateOptions, WorkerLike, } from './run/browser-isolate.js';
+export { isNetBridgeRequest, serveNetRequest } from './run/net-bridge.js';
+export type { NetBridgeReply, NetBridgeRequest } from './run/net-bridge.js';
+export type { CacheSnapshot, RunOnceOptions, RunOnceResult, } from './run/run-flow.js';
+export { MAX_CACHE_SNAPSHOT_BYTES, MAX_VALUES_SNAPSHOT_BYTES, cacheStorageKeyFor, isCacheSnapshotShape, mergePersistedValues, readPersistedValues, runOnce, serializeCacheSnapshotIfSmallEnough, valuesStorageKeyFor, } from './run/run-flow.js';
+export type { GrantFlowOptions, GrantFlowRequirements, GrantFlowResult, GrantMemento, PromptHost, PromptManyHosts, PromptUnknownHosts, Thenable, } from './run/grant-flow.js';
+export { ALLOW_LABEL, DONT_ALLOW_LABEL, MAX_HOST_PROMPTS, UNKNOWN_HOSTS_PROMPT_MESSAGE, clearGrantForDocument, hostPromptMessage, isSafeHostForPrompt, manyHostsPromptMessage, resolveStoredGrant, runGrantFlow, } from './run/grant-flow.js';
+export type { BuildBundleSnapshotOptions, BundleSnapshotResult, EncodedBundleCache, } from './run/bundle-run.js';
+export { DEFAULT_MAX_BUNDLE_SNAPSHOT_BYTES, DEFAULT_MAX_BUNDLE_SNAPSHOT_FILE_BYTES, MAX_PERSISTED_BUNDLE_CACHE_BYTES, buildBundleSnapshot, bundleModulesFromSnapshot, cacheFilesFrom, decodeBundleCacheFromStorage, encodeBundleCacheForStorage, manifestBundleFsGrants, manifestNetHosts, netDeclarationDiagnostics, withPersistedCache, } from './run/bundle-run.js';
+export { BUNDLE_EXTENSION, DEFAULT_BUNDLE_DOCUMENT_PATH, LEGACY_BUNDLE_EXTENSION, isBundleName, resolveBundleDocumentPath, } from './run/bundle-document.js';
+export type { RunTrace } from './run/run-trace.js';
+export { isRunTrace, lastRunStorageKeyFor, readLastRunTrace, writeLastRunTrace, } from './run/run-trace.js';
+export type { RunRequirements } from './run/script-requirements.js';
+export { extractRunRequirements } from './run/script-requirements.js';
+export type { SnapshotStorage } from './run/snapshot-storage.js';
+export { createSnapshotStorage } from './run/snapshot-storage.js';
+export { staleValuesForRehydration } from './run/stale-values.js';
+export type { HtmlExportEngine, CascadeIndexEntry, ComposeNoteHtmlExportOptions, ExportBodyRenderer, ExportBodyResult, ExportExtension, ExportPackStylesheet, ExportRenderInfo, NoteExportBuildRequest, NoteExportDocument, NoteHtmlExportOptions, StaticExportReason, } from './export/note-export.js';
+export { EXPORT_HIDE_SCRIPT_BLOCKS_CLASS, EXPORT_PAGE_CSS, FALLBACK_EXPORT_BASE_NAME, MARK_EXTENSION, buildCascadeIndexHtml, buildNoteExport, buildNoteHtmlExport, composeNoteHtmlExport, noteHasScripts, exportBaseName, exportDocumentTitle, exportedFileName, exportedSiblingPath, packStylesheetsCss, } from './export/note-export.js';
+export type { EmbeddedImageReport, ExportImageReader, ExportImageResult, ImageSkipReason, SkippedImage, } from './export/image-embed.js';
+export { EMBEDDABLE_IMAGE_EXTENSIONS, EMPTY_IMAGE_REPORT, MAX_EMBEDDED_IMAGE_BYTES, embedImagesInHtml, encodeBase64, isEmbeddableImageSrc, mimeTypeForImageSrc, toImageDataUri, } from './export/image-embed.js';
+export type { NoteLink, NoteLinkTargetResolver } from './export/note-links.js';
+export { extractNoteLinks, isLocalNoteTarget, maskCodeRegions, rewriteNoteLinks, } from './export/note-links.js';
+export type { CascadeLinkResolver, CascadeNote, CascadeNoteReader, CascadeTruncation, CascadeWalkOptions, CascadeWalkResult, } from './export/cascade.js';
+export { CASCADE_INDEX_FILE_NAME, DEFAULT_CASCADE_MAX_DEPTH, DEFAULT_CASCADE_MAX_NOTES, assignCascadeFileNames, rewriteCascadeLinks, walkNoteCascade, } from './export/cascade.js';
+export type { CascadeArchiveRequest, CascadeArchiveResult, CascadeExportOutcome, CascadeExportedNote, UnreadableCascadeNote, } from './host/cascade-export-behavior.js';
+export { buildCascadeArchive, cascadeDiagnosticLines, cascadeReasonOf, cascadeResultMessage, countedNoun, } from './host/cascade-export-behavior.js';
+export type { ExportArchiveEntry } from './export/export-zip.js';
+export { zipExportArchive } from './export/export-zip.js';
+export type { HostLookup, PinnedAddress, PinPolicy, PinResult, ResolvedAddress, } from './run/net-pinning.js';
+export { pinHostAddress, pinnedLookup } from './run/net-pinning.js';
+export type { AddressScope } from './run/ip-address.js';
+export { classifyIpAddress, describeScope, isRestrictedScope, } from './run/ip-address.js';
+export type { PackModulesMap } from './run/lua-resolver.js';
+export { createPackModuleResolver } from './run/lua-resolver.js';
+export type { DiscoveredPack, DiscoverPacksResult, EngineUnsupportedPack, PackDirectoryLister, SkippedPackFolder, } from './packs/discover.js';
+export { componentsWithoutEngineView, declaredPackComponents, discoverPacks, installedNamespaces, } from './packs/discover.js';
+export type { PackScriptsReader } from './packs/pack-scripts.js';
+export { loadPackModules } from './packs/pack-scripts.js';
+export { relativePackEntries, resolvePackPaths } from './packs/pack-paths.js';
+export type { PackDiagnosticsContext, PackDiagnosticsPack, PackDiagnosticsSkippedFolder, } from './packs/pack-diagnostics.js';
+export { formatPackDiagnosticLines, skippedPackCount, } from './packs/pack-diagnostics.js';
+export type { PackPathExists, PrebuiltPackResolution, } from './packs/prebuilt.js';
+export { PREBUILT_SCRIPT_FILENAME, PREBUILT_STYLESHEET_FILENAME, PREBUILT_TERMINAL_SCRIPT_FILENAME, emptyWebviewScript, prebuiltScriptPathFor, prebuiltStylesheetPathFor, prebuiltTerminalScriptPathFor, resolvePrebuiltPack, } from './packs/prebuilt.js';
+export type { BuildRenderRegistryResult, DuplicateComposedName, PackRegistryEngine, QueuedPackRegistration, } from './packs/pack-render-registry.js';
+export { buildRenderRegistry } from './packs/pack-render-registry.js';
+export type { ComponentSkeleton, LineColumn } from '@markii/stdlib/editor';
+export { componentSkeleton, offsetToLineColumn } from '@markii/stdlib/editor';
+export { LAYOUT_WRAPPER_NAMES } from '@markii/stdlib/editor';
+export type { InsertableComponent } from '@markii/stdlib/editor';
+export type { PackComponentAttribute } from '@markii/pack';
+export { buildComponentCatalog } from './insert/component-catalog.js';
+export type { CompletionContext, CompletionContextKind, CompletionItem, CompletionItemKind, ComponentDocumentation, HoverInfo, } from '@markii/stdlib/editor';
+export { completionAt, componentDocumentation, formatComponentDocumentation, hoverAt, } from '@markii/stdlib/editor';
+export type { EnclosingContainerFence, FenceLineEdit, } from '@markii/stdlib/editor';
+export { closesOpenContainerFence, enclosingContainerFences, fenceExtensionEdits, insertedContainerColonCount, } from '@markii/stdlib/editor';
+export { createRenderDiagnosticCollector, createRenderDiagnosticReporter, renderDiagnosticLine, } from './diagnostics/render-diagnostics.js';
+export type { HostAdapter, HostDirEntry, HostEditor, HostExportCapabilities, HostExportFormat, HostIsolate, HostLabels, HostPackSource, HostPromptRequest, HostTextEdit, } from './host/adapter.js';
+export { BROWSER_ISOLATE_ENTRY } from './host/adapter.js';
+export { CLI_LABELS, OBSIDIAN_LABELS, VSCODE_LABELS, packsNotInstalledLabel, } from './host/labels.js';
+export { scheduledRefreshNotStartedLine, scriptsDisabledConfirmationText, scriptsDisabledDiagnosticLine, scriptsDisabledNotice, scriptsDisabledNoticeText, scriptsEnabledConfirmationText, } from './host/script-execution.js';
+export { MIN_REFRESH_INTERVAL_SECONDS, parseRefreshIntervalSeconds, refreshIntervalMsFromSeconds, refreshIntervalValidationMessage, } from './host/refresh-interval.js';
+export { promptsFromAdapter, runViaAdapter, spawnRunViaAdapter, RUN_TIMEOUT_MS as HOST_RUN_TIMEOUT_MS, } from './host/run-behavior.js';
+export type { RunViaAdapterRequest, RunViaAdapterResult, } from './host/run-behavior.js';
+export { formatRunFailureLines, runDiagnosticLines, } from './host/run-diagnostics.js';
+export type { ArchiveExtractFs } from './host/pack-archive.js';
+export { describeArchiveError, writeArchiveContents, } from './host/pack-archive.js';
+export type { InstallPackFromArchiveOptions, PackDirectoryExists, } from './host/pack-install.js';
+export { installConsentMessage, installPackDiagnosticLines, installPackFromArchive, installPackMessage, installReplaceConfirmMessage, } from './host/pack-install.js';
+export type { LoadPacksResult, PackDiscoveryIo } from './host/pack-load.js';
+export { discoverConfiguredPacks, loadPacksViaAdapter, packDiscoveryIoFromAdapter, } from './host/pack-load.js';
+export { prebuiltShadowLine } from './packs/pack-diagnostics.js';
+export type { ReadTerminalScriptsResult, TerminalPackScript, } from './host/terminal-packs.js';
+export { packHasTerminalViews, readTerminalPackScripts, terminalScriptMissingLine, terminalScriptNamespaceMismatchLine, terminalScriptRejectedLine, terminalScriptUnreadableLine, } from './host/terminal-packs.js';
+export type { RemovePackOutcome } from './host/pack-remove.js';
+export type { PackTrustEntry, PackTrustList } from './packs/pack-trust.js';
+export { DEFAULT_PACK_TRUST_LIST, MAX_TRUSTED_PACKS, PACK_TRUST_STORAGE_KEY, isPackTrusted, normalizePackTrustList, trustPack, untrustPack, } from './packs/pack-trust.js';
+export type { DisablePackOutcome, EnabledPack, EnablePackOutcome, InstalledPacksListing, } from './host/pack-trust-behavior.js';
+export { disablePackMessage, enablePackMessage, notEnabledPackDiagnosticLine, selectEnabledPacks, } from './host/pack-trust-behavior.js';
+export { removePackDiagnosticLine, removePackMessage, removePackViaAdapter, } from './host/pack-remove.js';
+export { mdPlainFromSource } from './host/export/md-plain.js';
+export type { ExportHtmlDocumentRequest, NoteFileExportOutcome, } from './host/export-behavior.js';
+export { buildExportDocument, exportDefaultFileName, exportDiagnosticLines, exportNoteFileViaAdapter, exportResultMessage, fileNameOf, formatByteSize, imageEmbedDiagnosticLines, renderEngineDiagnosticLine, } from './host/export-behavior.js';
+export type { CatalogCache, CompletionPlan, InsertComponentEdit, InsertComponentPlan, } from './host/editor-behavior.js';
+export { LAYOUT_ORIGIN_TAG, STANDARD_ORIGIN_TAG, completeAtViaEditor, completionOriginTag, completionPlanAt, createCatalogCache, hoverAtViaEditor, hoverDocumentationText, insertComponentPlan, isContainerCompletionItem, } from './host/editor-behavior.js';
+export { createMarkiiHost } from './host/create-host.js';
+export type { CompleteOutcome, EditorPositionRequest, ExportOutcome, ExportRequest, HoverOutcome, InsertComponentRequest, InstallPackOutcome, InstallPackRequest, LoadPacksOutcome, LoadTerminalPacksOutcome, MarkiiHost, MarkiiHostOptions, OpenOutcome, OpenRequest, RemovePackResult, DisablePackResult, EnablePackResult, InstalledPacksOutcome, RunOutcome, RunRequest, Unsupported, } from './host/create-host.js';
+export { joinPath, dirnamePath, isAbsolutePath } from './path-util.js';

package/dist/index.js

@@ -0,0 +1,70 @@
+// @markii/host: the shared, host-neutral script-running layer for Markii
+// hosts (`apps/vscode`, and any future host such as an Obsidian plugin).
+// Environment-neutral: nothing reachable from this entry imports `node:*`,
+// `esbuild-wasm`, `@markii/react` or `@markii/html` at runtime
+// (`apps/vscode/src/browser-entry.probe.test.ts` bundles it for a browser to
+// prove it). What needs Node lives in `./node.ts`, published as
+// `@markii/host/node`. Private workspace package: never published,
+// never added to `build:dist`. See AGENTS.md's repo-layout entry for
+// `packages/markii-host` for the module-by-module breakdown.
+//
+// This is the security-critical layer (tier gating, the grant model,
+// DNS/address pinning, the terminatable-isolate watchdog) — a second,
+// drifting copy of any of this is the one outcome to avoid, which is why
+// it lives here instead of inside `apps/vscode`.
+export { mergeArrivingValue } from './values-merge.js';
+export { isRunProgress } from './run/run-progress.js';
+export { spawnRun } from './run/run-host.js';
+export { createBrowserIsolate } from './run/browser-isolate.js';
+export { isNetBridgeRequest, serveNetRequest } from './run/net-bridge.js';
+export { MAX_CACHE_SNAPSHOT_BYTES, MAX_VALUES_SNAPSHOT_BYTES, cacheStorageKeyFor, isCacheSnapshotShape, mergePersistedValues, readPersistedValues, runOnce, serializeCacheSnapshotIfSmallEnough, valuesStorageKeyFor, } from './run/run-flow.js';
+export { ALLOW_LABEL, DONT_ALLOW_LABEL, MAX_HOST_PROMPTS, UNKNOWN_HOSTS_PROMPT_MESSAGE, clearGrantForDocument, hostPromptMessage, isSafeHostForPrompt, manyHostsPromptMessage, resolveStoredGrant, runGrantFlow, } from './run/grant-flow.js';
+export { DEFAULT_MAX_BUNDLE_SNAPSHOT_BYTES, DEFAULT_MAX_BUNDLE_SNAPSHOT_FILE_BYTES, MAX_PERSISTED_BUNDLE_CACHE_BYTES, buildBundleSnapshot, bundleModulesFromSnapshot, cacheFilesFrom, decodeBundleCacheFromStorage, encodeBundleCacheForStorage, manifestBundleFsGrants, manifestNetHosts, netDeclarationDiagnostics, withPersistedCache, } from './run/bundle-run.js';
+export { BUNDLE_EXTENSION, DEFAULT_BUNDLE_DOCUMENT_PATH, LEGACY_BUNDLE_EXTENSION, isBundleName, resolveBundleDocumentPath, } from './run/bundle-document.js';
+export { isRunTrace, lastRunStorageKeyFor, readLastRunTrace, writeLastRunTrace, } from './run/run-trace.js';
+export { extractRunRequirements } from './run/script-requirements.js';
+export { createSnapshotStorage } from './run/snapshot-storage.js';
+export { staleValuesForRehydration } from './run/stale-values.js';
+export { EXPORT_HIDE_SCRIPT_BLOCKS_CLASS, EXPORT_PAGE_CSS, FALLBACK_EXPORT_BASE_NAME, MARK_EXTENSION, buildCascadeIndexHtml, buildNoteExport, buildNoteHtmlExport, composeNoteHtmlExport, noteHasScripts, exportBaseName, exportDocumentTitle, exportedFileName, exportedSiblingPath, packStylesheetsCss, } from './export/note-export.js';
+export { EMBEDDABLE_IMAGE_EXTENSIONS, EMPTY_IMAGE_REPORT, MAX_EMBEDDED_IMAGE_BYTES, embedImagesInHtml, encodeBase64, isEmbeddableImageSrc, mimeTypeForImageSrc, toImageDataUri, } from './export/image-embed.js';
+export { extractNoteLinks, isLocalNoteTarget, maskCodeRegions, rewriteNoteLinks, } from './export/note-links.js';
+export { CASCADE_INDEX_FILE_NAME, DEFAULT_CASCADE_MAX_DEPTH, DEFAULT_CASCADE_MAX_NOTES, assignCascadeFileNames, rewriteCascadeLinks, walkNoteCascade, } from './export/cascade.js';
+export { buildCascadeArchive, cascadeDiagnosticLines, cascadeReasonOf, cascadeResultMessage, countedNoun, } from './host/cascade-export-behavior.js';
+export { zipExportArchive } from './export/export-zip.js';
+export { pinHostAddress, pinnedLookup } from './run/net-pinning.js';
+export { classifyIpAddress, describeScope, isRestrictedScope, } from './run/ip-address.js';
+export { createPackModuleResolver } from './run/lua-resolver.js';
+export { componentsWithoutEngineView, declaredPackComponents, discoverPacks, installedNamespaces, } from './packs/discover.js';
+export { loadPackModules } from './packs/pack-scripts.js';
+export { relativePackEntries, resolvePackPaths } from './packs/pack-paths.js';
+export { formatPackDiagnosticLines, skippedPackCount, } from './packs/pack-diagnostics.js';
+export { PREBUILT_SCRIPT_FILENAME, PREBUILT_STYLESHEET_FILENAME, PREBUILT_TERMINAL_SCRIPT_FILENAME, emptyWebviewScript, prebuiltScriptPathFor, prebuiltStylesheetPathFor, prebuiltTerminalScriptPathFor, resolvePrebuiltPack, } from './packs/prebuilt.js';
+export { buildRenderRegistry } from './packs/pack-render-registry.js';
+export { componentSkeleton, offsetToLineColumn } from '@markii/stdlib/editor';
+export { LAYOUT_WRAPPER_NAMES } from '@markii/stdlib/editor';
+export { buildComponentCatalog } from './insert/component-catalog.js';
+export { completionAt, componentDocumentation, formatComponentDocumentation, hoverAt, } from '@markii/stdlib/editor';
+export { closesOpenContainerFence, enclosingContainerFences, fenceExtensionEdits, insertedContainerColonCount, } from '@markii/stdlib/editor';
+// Render-time diagnostics: one event from either renderer's `onDiagnostic`
+// option becomes the one line both hosts write to their diagnostics
+// surface.
+export { createRenderDiagnosticCollector, createRenderDiagnosticReporter, renderDiagnosticLine, } from './diagnostics/render-diagnostics.js';
+export { BROWSER_ISOLATE_ENTRY } from './host/adapter.js';
+export { CLI_LABELS, OBSIDIAN_LABELS, VSCODE_LABELS, packsNotInstalledLabel, } from './host/labels.js';
+export { scheduledRefreshNotStartedLine, scriptsDisabledConfirmationText, scriptsDisabledDiagnosticLine, scriptsDisabledNotice, scriptsDisabledNoticeText, scriptsEnabledConfirmationText, } from './host/script-execution.js';
+export { MIN_REFRESH_INTERVAL_SECONDS, parseRefreshIntervalSeconds, refreshIntervalMsFromSeconds, refreshIntervalValidationMessage, } from './host/refresh-interval.js';
+export { promptsFromAdapter, runViaAdapter, spawnRunViaAdapter, RUN_TIMEOUT_MS as HOST_RUN_TIMEOUT_MS, } from './host/run-behavior.js';
+export { formatRunFailureLines, runDiagnosticLines, } from './host/run-diagnostics.js';
+export { describeArchiveError, writeArchiveContents, } from './host/pack-archive.js';
+export { installConsentMessage, installPackDiagnosticLines, installPackFromArchive, installPackMessage, installReplaceConfirmMessage, } from './host/pack-install.js';
+export { discoverConfiguredPacks, loadPacksViaAdapter, packDiscoveryIoFromAdapter, } from './host/pack-load.js';
+export { prebuiltShadowLine } from './packs/pack-diagnostics.js';
+export { packHasTerminalViews, readTerminalPackScripts, terminalScriptMissingLine, terminalScriptNamespaceMismatchLine, terminalScriptRejectedLine, terminalScriptUnreadableLine, } from './host/terminal-packs.js';
+export { DEFAULT_PACK_TRUST_LIST, MAX_TRUSTED_PACKS, PACK_TRUST_STORAGE_KEY, isPackTrusted, normalizePackTrustList, trustPack, untrustPack, } from './packs/pack-trust.js';
+export { disablePackMessage, enablePackMessage, notEnabledPackDiagnosticLine, selectEnabledPacks, } from './host/pack-trust-behavior.js';
+export { removePackDiagnosticLine, removePackMessage, removePackViaAdapter, } from './host/pack-remove.js';
+export { mdPlainFromSource } from './host/export/md-plain.js';
+export { buildExportDocument, exportDefaultFileName, exportDiagnosticLines, exportNoteFileViaAdapter, exportResultMessage, fileNameOf, formatByteSize, imageEmbedDiagnosticLines, renderEngineDiagnosticLine, } from './host/export-behavior.js';
+export { LAYOUT_ORIGIN_TAG, STANDARD_ORIGIN_TAG, completeAtViaEditor, completionOriginTag, completionPlanAt, createCatalogCache, hoverAtViaEditor, hoverDocumentationText, insertComponentPlan, isContainerCompletionItem, } from './host/editor-behavior.js';
+export { createMarkiiHost } from './host/create-host.js';
+export { joinPath, dirnamePath, isAbsolutePath } from './path-util.js';

package/dist/insert/component-catalog.d.ts

@@ -0,0 +1,23 @@
+import { LAYOUT_WRAPPER_NAMES } from '@markii/stdlib/editor';
+import type { InsertableComponent } from '@markii/stdlib/editor';
+import type { DiscoveredPack } from '../packs/discover.js';
+export { LAYOUT_WRAPPER_NAMES };
+export type { InsertableComponent };
+/**
+ * Builds the full insert catalog: `@markii/stdlib/editor`'s standard-set
+ * list, then each pack's components (in the order `packs` is given, each
+ * pack's own local names sorted alphabetically). A host renders a picker's
+ * sections straight off this order — standard section, layout section,
+ * then one section per pack — without needing to re-sort or re-group the
+ * result itself.
+ *
+ * A pack component whose composed directive name collides with the
+ * standard set or with an earlier pack's entry is skipped, so the returned
+ * list never has two entries with the same `directiveName`.
+ *
+ * `engine`, when given, keeps only the pack components that have a source
+ * for that engine (the host's renderer): a component without one renders
+ * as the unknown fallback there, so it is not offered. Omitted, every
+ * declared component is listed.
+ */
+export declare function buildComponentCatalog(packs: readonly DiscoveredPack[], engine?: string): readonly InsertableComponent[];

package/dist/insert/component-catalog.js

@@ -0,0 +1,96 @@
+/**
+ * "Insert Component" (GitHub issue #17, slice 1): the PACK-AWARE half of
+ * the insert catalog. `@markii/stdlib/editor`'s `standardComponentCatalog`
+ * (GitHub issue #41) is the standard-set half — every `@markii/stdlib`
+ * standard component, with no dependency on `@markii/pack` at all — and
+ * this module composes it with one entry per component every currently
+ * discovered pack declares. This split is why `@markii/stdlib` can stay at
+ * zero dependencies while a pack-less host (or a third-party editor
+ * integration that never imports `@markii/pack`) still gets the full
+ * standard-set catalog for free.
+ *
+ * Host-neutral and pure: no `vscode`, no `obsidian`, no filesystem access
+ * of its own (packs are handed in already discovered, via
+ * `@markii/host`'s own `discoverPacks`/`DiscoveredPack`).
+ *
+ * Never throws. A malformed pack (an empty or missing `components` map, or
+ * a local name that fails `@markii/pack`'s namespace validation) simply
+ * contributes nothing — the same cleanliness posture as `./discover.ts`.
+ * A pack component's declared attribute metadata (`pack.json`'s optional
+ * `attributes` list, issue #27 slice 4) is carried through untouched;
+ * `@markii/pack`'s `packComponents` has already dropped anything malformed
+ * in it, so this module never re-validates it.
+ */
+import { composeDirectiveName, packComponents, packComponentsForEngine, } from '@markii/pack';
+import { LAYOUT_WRAPPER_NAMES, standardComponentCatalog, } from '@markii/stdlib/editor';
+export { LAYOUT_WRAPPER_NAMES };
+/**
+ * One pack's contribution to the catalog: its declared components
+ * (`@markii/pack`'s `packComponents`, sorted alphabetically by local name
+ * for determinism), each composed into a directive name via
+ * `@markii/pack`'s `composeDirectiveName`. A local name that fails
+ * composition (an invalid namespace or local-name shape) is skipped —
+ * never thrown. `taken` is a set of directive names already claimed (by
+ * the standard set, or by an earlier pack) that this pack must not collide
+ * with; a colliding name is skipped and `taken` is left unchanged for it
+ * (first entry keeps the name).
+ */
+function packCatalogEntries(pack, taken, engine) {
+    const all = engine === undefined
+        ? packComponents(pack.manifest)
+        : packComponentsForEngine(pack.manifest, engine);
+    const listings = [...all].sort((a, b) => a.localName < b.localName ? -1 : a.localName > b.localName ? 1 : 0);
+    const entries = [];
+    for (const listing of listings) {
+        const composed = composeDirectiveName(pack.manifest.name, listing.localName);
+        if (!composed.ok)
+            continue;
+        if (taken.has(composed.name))
+            continue;
+        taken.add(composed.name);
+        entries.push({
+            directiveName: composed.name,
+            kind: listing.kind ?? 'container',
+            source: 'pack',
+            group: 'pack',
+            packName: pack.manifest.name,
+            ...(listing.description !== undefined
+                ? { description: listing.description }
+                : {}),
+            requiredAttributes: (listing.attributes ?? [])
+                .filter((attribute) => attribute.required === true)
+                .map((attribute) => attribute.name),
+            ...(listing.attributes !== undefined
+                ? { attributes: listing.attributes }
+                : {}),
+            kindDeclared: listing.kind !== undefined,
+        });
+    }
+    return entries;
+}
+/**
+ * Builds the full insert catalog: `@markii/stdlib/editor`'s standard-set
+ * list, then each pack's components (in the order `packs` is given, each
+ * pack's own local names sorted alphabetically). A host renders a picker's
+ * sections straight off this order — standard section, layout section,
+ * then one section per pack — without needing to re-sort or re-group the
+ * result itself.
+ *
+ * A pack component whose composed directive name collides with the
+ * standard set or with an earlier pack's entry is skipped, so the returned
+ * list never has two entries with the same `directiveName`.
+ *
+ * `engine`, when given, keeps only the pack components that have a source
+ * for that engine (the host's renderer): a component without one renders
+ * as the unknown fallback there, so it is not offered. Omitted, every
+ * declared component is listed.
+ */
+export function buildComponentCatalog(packs, engine) {
+    const standard = standardComponentCatalog();
+    const taken = new Set(standard.map((entry) => entry.directiveName));
+    const packEntries = [];
+    for (const pack of packs) {
+        packEntries.push(...packCatalogEntries(pack, taken, engine));
+    }
+    return [...standard, ...packEntries];
+}

package/dist/node-fs.d.ts

@@ -0,0 +1,14 @@
+import type { ArchiveExtractFs } from './host/pack-archive.js';
+import type { PackDiscoveryIo } from './host/pack-load.js';
+import type { PackDirectoryLister, PackFileReader } from './packs/discover.js';
+import type { PackScriptsReader } from './packs/pack-scripts.js';
+/** The real, Node-backed `PackDirectoryLister`. Never rejects: an unreadable, missing or non-directory path resolves `[]`. */
+export declare function createNodeDirectoryLister(): PackDirectoryLister;
+/** The real, Node-backed `PackFileReader`. Never rejects: an unreadable or missing path resolves `undefined`. */
+export declare function createNodeFileReader(): PackFileReader;
+/** The real, Node-backed `PackScriptsReader`. */
+export declare function createNodeReader(): PackScriptsReader;
+/** The real, Node-backed `ArchiveExtractFs`. */
+export declare function createNodeArchiveExtractFs(): ArchiveExtractFs;
+/** Pack discovery's reads over the real file system. */
+export declare function createNodePackDiscoveryIo(): PackDiscoveryIo;