@markii/host 0.0.1 → 0.17.0-next.3

package/dist/values-failure.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `ValuesFailure` is the wire-protocol shape a host uses to report one
+ * script's failure back to its renderer/webview: the script's name and a
+ * closed `FailureKind`, never the raw error message (the rendered page
+ * shows quiet markers, never error dumps — see AGENTS.md's cleanliness
+ * principle). Defined here, in the shared host layer, so every host
+ * (`apps/vscode`, and any future host) and this package's own `run-flow.ts`
+ * agree on a single definition instead of drifting copies; a consuming
+ * app's own wire-protocol module (e.g. `apps/vscode/src/protocol.ts`) is
+ * expected to import and re-export this type rather than restate it.
+ */
+import type { FailureKind } from '@markii/runtime';
+/** One script's outcome, reduced to just its name and failure kind — never the raw error message. */
+export interface ValuesFailure {
+    readonly name: string;
+    readonly kind: FailureKind;
+}

package/dist/values-failure.js

@@ -0,0 +1 @@
+export {};

package/dist/values-merge.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The one way a host folds a single arriving value into the value store its
+ * preview is rendering from (GitHub issue #35).
+ *
+ * A run reports its values one at a time, in document order, while it is
+ * still going. Each arrival has to replace exactly one name and leave every
+ * other name exactly as it was — that is what makes the bound component go
+ * fresh while the rest of the note stays visibly stale, instead of the
+ * whole page flipping at the end of the batch.
+ *
+ * It lives here, in the shared host layer, because both hosts do it: the VS
+ * Code webview folds a `value` wire message into its React state, and the
+ * Obsidian view folds a callback's value into the store it re-renders from.
+ * Two copies of a merge this small still drift, and the `__proto__` rule
+ * below is exactly the kind of detail one copy would quietly lose.
+ *
+ * Environment-free on purpose (no `node:*`, no React), so the main entry
+ * can export it and a browser bundle can import it.
+ */
+import type { StoredValue } from '@markii/runtime';
+/**
+ * `values` with `name` set to `value`, as a NEW object — the input is never
+ * mutated, so a caller holding the previous store (React state, a view's
+ * last-rendered snapshot) can still compare against it.
+ *
+ * A name already present keeps its POSITION and takes the new value; a new
+ * name is appended. Order is not semantically meaningful to a renderer, but
+ * a store whose keys reshuffle on every value would make any diff of two
+ * snapshots harder to read than it needs to be.
+ *
+ * Built through `Object.fromEntries` rather than `{...values, [name]: value}`
+ * because a script may legitimately be named `__proto__` (docs/spec.md's
+ * name grammar allows it): a computed assignment of that key hits
+ * `Object.prototype`'s setter, which sets the object's prototype and
+ * creates no own property at all, silently dropping the value. The same
+ * guard is in `run/run-flow.ts`'s `mergePersistedValues` and
+ * `run/stale-values.ts`, for the same reason.
+ */
+export declare function mergeArrivingValue(values: Readonly<Record<string, StoredValue>> | undefined, name: string, value: StoredValue): Record<string, StoredValue>;

package/dist/values-merge.js

@@ -0,0 +1,33 @@
+/**
+ * `values` with `name` set to `value`, as a NEW object — the input is never
+ * mutated, so a caller holding the previous store (React state, a view's
+ * last-rendered snapshot) can still compare against it.
+ *
+ * A name already present keeps its POSITION and takes the new value; a new
+ * name is appended. Order is not semantically meaningful to a renderer, but
+ * a store whose keys reshuffle on every value would make any diff of two
+ * snapshots harder to read than it needs to be.
+ *
+ * Built through `Object.fromEntries` rather than `{...values, [name]: value}`
+ * because a script may legitimately be named `__proto__` (docs/spec.md's
+ * name grammar allows it): a computed assignment of that key hits
+ * `Object.prototype`'s setter, which sets the object's prototype and
+ * creates no own property at all, silently dropping the value. The same
+ * guard is in `run/run-flow.ts`'s `mergePersistedValues` and
+ * `run/stale-values.ts`, for the same reason.
+ */
+export function mergeArrivingValue(values, name, value) {
+    const entries = [];
+    let replaced = false;
+    for (const [key, existing] of Object.entries(values ?? {})) {
+        if (key === name) {
+            entries.push([key, value]);
+            replaced = true;
+            continue;
+        }
+        entries.push([key, existing]);
+    }
+    if (!replaced)
+        entries.push([name, value]);
+    return Object.fromEntries(entries);
+}

package/package.json

@@ -1,13 +1,89 @@
 {
   "name": "@markii/host",
-  "version": "0.0.1",
-  "description": "Markii host layer: run, packs, export and editor behaviors shared by every host app.",
+  "version": "0.17.0-next.3",
+  "description": "Shared, host-neutral script-running layer for Markii hosts: tier gating, the grant model, address pinning, and the terminatable-isolate watchdog, plus the HostAdapter contract and createMarkiiHost. Entries: the neutral main entry, /node, /browser, /conformance.",
+  "keywords": [
+    "markdown",
+    "mk.md",
+    "markii",
+    "host",
+    "sandbox"
+  ],
   "license": "MIT",
+  "author": "sadigaxund",
+  "homepage": "https://github.com/markii-org/markii#readme",
+  "bugs": "https://github.com/markii-org/markii/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/markii-org/markii.git",
     "directory": "packages/markii-host"
   },
-  "homepage": "https://github.com/markii-org/markii#readme",
-  "files": ["README.md", "LICENSE"]
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./node-worker": {
+      "default": "./dist/node-worker.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
+    "./conformance": {
+      "types": "./dist/conformance.d.ts",
+      "import": "./dist/conformance.js",
+      "default": "./dist/conformance.js"
+    }
+  },
+  "scripts": {
+    "pretest": "npm run generate:doc-css --workspace @markii/html",
+    "test": "vitest run",
+    "prebuild": "npm run generate:doc-css --workspace @markii/html",
+    "build": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint .",
+    "build:dist": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/build-dist-assets.mjs"
+  },
+  "dependencies": {
+    "@markii/bundle": "^0.17.0-next.3",
+    "@markii/core": "^0.17.0-next.3",
+    "@markii/lua": "^0.17.0-next.3",
+    "@markii/pack": "^0.17.0-next.3",
+    "@markii/runtime": "^0.17.0-next.3",
+    "@markii/stdlib": "^0.17.0-next.3",
+    "fflate": "^0.8.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@markii/html": "^0.17.0-next.3",
+    "@markii/react": "^0.17.0-next.3"
+  },
+  "peerDependenciesMeta": {
+    "@markii/html": {
+      "optional": true
+    },
+    "@markii/react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@markii/html": "^0.17.0-next.3",
+    "@markii/react": "^0.17.0-next.3",
+    "esbuild": "^0.28.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }