@pygmalionjs/pygmalion 0.9.0 → 0.11.0

package/README.md

@@ -442,6 +442,40 @@ Shared edits update detailed active frames and lightweight inactive frames in
 the same render cycle. A frame does not need to be activated before it reflects
 a shared change.
 
+### Connect source adapters to SDK services
+
+The host supplies screen declarations, source mappings, authentication or mock
+setup, and build commands. Pygmalion owns reusable execution, revision caching,
+source review, and cancellation. Keep SDK implementation and regression tests
+in Pygmalion; host tests continue to cover the product's own behavior.
+
+| Package subpath | Responsibility |
+| --- | --- |
+| `./host-runtime` | Process-group cleanup, revision catalog queues and caches, isolated source roots, and lockfile-matched dependencies. |
+| `./source-service` | Source and token review receipts, apply validation, reconciliation sessions, and local JSON transport. |
+| `./source-reconciler` | Reconcile draft structure with external source edits using host-supplied source identity mappings. |
+| `./draft-entry` | Generate a browser entry that applies the declared draft recipe and reports readiness or failure. |
+| `./source-module` | Evaluate a trusted declaration bundle using the host's bundler configuration. |
+
+For example, declare a build command in the host and let the SDK wait for its
+process group to stop before an archive can be removed:
+
+```js
+import { executeWorkspaceDraftProcess } from '@pygmalionjs/pygmalion/host-runtime';
+
+export function buildPreview({ cwd, signal }) {
+  return executeWorkspaceDraftProcess(process.execPath, ['scripts/build-preview.mjs'], {
+    cwd,
+    signal,
+    timeout: 120_000,
+  });
+}
+```
+
+Process-group cleanup supports macOS and Linux. Catalog generation callbacks
+receive an isolated archive for the exact requested commit; cancelling one
+catalog request does not cancel generation shared with another caller.
+
 ## Local development
 
 ```bash

package/dist-lib/{CameraLayer-BdOko8XE.js → CameraLayer-BZ8HgrUG.js}

@@ -1,5 +1,5 @@
 import { jsx as p } from "react/jsx-runtime";
-import { j as g, R as C, aI as P, ce as R, cf as E, U as I, cg as k, a3 as m, a0 as b } from "./runtime-Dxb-IaLN.js";
+import { j as g, R as C, aI as P, cf as R, cg as E, U as I, ch as k, a3 as m, a0 as b } from "./runtime-Bxn8116i.js";
 import { useRef as L, useLayoutEffect as h } from "react";
 function f(n) {
   return `translate(${n.panX}px, ${n.panY}px) scale(${n.zoom})`;