@pygmalionjs/pygmalion 0.8.1 → 0.10.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/binding-source.d.ts

@@ -0,0 +1,25 @@
+import type { BindingSourcePlan } from './dist-lib/types/binding/source.js';
+
+export interface SourceBindingProofOptions {
+  sourceRevision: string;
+  files: ReadonlyMap<string, string> | Readonly<Record<string, string>>;
+  /** Explicit files the host permits this design operation to change. */
+  allowedFiles: readonly string[];
+  /** DTO/schema and other host-owned exclusions take precedence over allowed files. */
+  excludedSourcePrefixes?: readonly string[];
+}
+
+export interface SourceBindingProofDiagnostic {
+  severity: 'error';
+  code: 'binding-source-plan-invalid' | 'binding-source-policy-invalid' | 'binding-source-empty'
+    | 'binding-source-proof-invalid' | 'binding-source-file-excluded' | 'binding-source-file-missing'
+    | 'binding-source-stale' | 'binding-source-overlap' | 'binding-source-anchor-invalid';
+  message: string;
+  file?: string;
+}
+
+/** Verify evidence without writing source or accepting a literal-prop inspection payload. */
+export declare function validateSourceBindingProofs(plan: BindingSourcePlan, options: SourceBindingProofOptions): {
+  valid: boolean;
+  diagnostics: SourceBindingProofDiagnostic[];
+};

package/dist-lib/{CameraLayer-B2D29VXQ.js → CameraLayer-BUOlJcUa.js}

@@ -1,13 +1,13 @@
 import { jsx as p } from "react/jsx-runtime";
-import { a as C, R as P, at as g, bB as R, bC as b, C as E, bD as k, P as m, K as I } from "./runtime-BAy8W1mJ.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-BOfDlGPR.js";
 import { useRef as L, useLayoutEffect as h } from "react";
-function v(n) {
+function f(n) {
   return `translate(${n.panX}px, ${n.panY}px) scale(${n.zoom})`;
 }
 function x(n, e, i, r = !1) {
   return r || k(n, e, i) ? void 0 : "none";
 }
-function f(n, e) {
+function v(n, e) {
   return x(
     n.editMode,
     n.tool,
@@ -18,7 +18,7 @@ function f(n, e) {
 const l = /* @__PURE__ */ new WeakMap();
 function z(n, e, i, r) {
   if (e.route == null) return 0;
-  const t = I(e) ?? e.route, a = e.width ?? 390, o = e.height ?? 600, c = n.declarations.getPreviewIdentityEpoch();
+  const t = b(e) ?? e.route, a = e.width ?? 390, o = e.height ?? 600, c = n.declarations.getPreviewIdentityEpoch();
   let s = l.get(e);
   (!s || s.revision !== i || s.epoch !== c || s.route !== t || s.width !== a || s.height !== o) && (s = {
     revision: i,
@@ -41,7 +41,7 @@ function F(n, e, i, r) {
   const c = e.width ?? 390;
   return c > 0 ? o.width / c : null;
 }
-function W(n) {
+function B(n) {
   return w(n).map((i) => {
     var t;
     const r = n.store.pages.find((a) => a.id === i.id);
@@ -61,13 +61,13 @@ function w(n) {
       x: t.x ?? 0,
       y: t.y ?? 0,
       width: t.width ?? 390,
-      height: E(t)
+      height: I(t)
     },
     pinned: t.id === e.activePageId || (r == null ? void 0 : r.kind) === "frame" && r.id === t.id || // A standby variant renders its full surface hidden at the group's
     // slot, so the switch to it has nothing left to mount.
     e.isScreenStateStandby(t) || // Catalog sheets need a full first render to replace their 1x1 seed.
     // Their live DOM remains mounted afterwards; offscreen paint may be skipped.
-    b(t) || n.schedulers.previewIntent.hasPreviewIntent(t.id),
+    E(t) || n.schedulers.previewIntent.hasPreviewIntent(t.id),
     weightBytes: z(n, t, i, t.id === e.activePageId),
     screenshotDensity: F(
       n,
@@ -77,20 +77,20 @@ function w(n) {
     )
   }));
 }
-let B = 0;
-function $({
+let O = 0;
+function D({
   children: n,
   interactionFrameId: e = null
 }) {
-  const i = C(), r = i.store, t = L(null);
+  const i = g(), r = i.store, t = L(null);
   return h(() => {
     const a = t.current;
     if (!a) return;
-    const o = new P(`CameraLayer#${++B}`, () => {
+    const o = new C(`CameraLayer#${++O}`, () => {
       o.isDisposed || c();
     }), c = () => {
       o.track(() => {
-        a.style.transform = v(r), a.style.pointerEvents = f(r, e) ?? "";
+        a.style.transform = f(r), a.style.pointerEvents = v(r, e) ?? "";
       });
     };
     return c(), () => o.dispose();
@@ -106,7 +106,7 @@ function $({
       // The live-screen budget follows the camera: the active frame first,
       // then the frames nearest the viewport take the remaining slots.
       onRecompute: ({ frames: o, camera: c, viewport: s }) => {
-        const { liveScreens: d } = i.schedulers, { activeId: u, siblingIds: y, groupSize: S } = g(() => ({
+        const { liveScreens: d } = i.schedulers, { activeId: u, siblingIds: y, groupSize: S } = P(() => ({
           activeId: r.activePageId,
           siblingIds: r.activeScreenStateSiblingIds,
           groupSize: r.activeScreenStateGroup.length
@@ -142,18 +142,18 @@ function $({
         position: "absolute",
         left: 0,
         top: 0,
-        transform: v(r),
+        transform: f(r),
         transformOrigin: "0 0",
         transition: "none",
         willChange: "transform",
-        pointerEvents: f(r, e)
+        pointerEvents: v(r, e)
       },
       children: n
     }
   );
 }
 export {
-  $ as CameraLayer,
-  W as __debugReadEditorFrames,
+  D as CameraLayer,
+  B as __debugReadEditorFrames,
   x as resolveCameraPointerEvents
 };