@superblocksteam/library-shared 1.99.99-next.3 → 2.0.0-SNAPSHOT.295fc0b43e332060

package/dist/props/tailwind-property-keys.js

@@ -0,0 +1,234 @@
+export const BORDER_RADIUS_PROPERTY_KEYS = [
+    "rounded",
+    "rounded-tl",
+    "rounded-tr",
+    "rounded-br",
+    "rounded-bl",
+    "rounded-t",
+    "rounded-r",
+    "rounded-b",
+    "rounded-l",
+];
+export const BORDER_PROPERTY_KEYS = [
+    "border-width",
+    "border-t-width",
+    "border-r-width",
+    "border-b-width",
+    "border-l-width",
+    // color
+    "border-color",
+    "border-t-color",
+    "border-r-color",
+    "border-b-color",
+    "border-l-color",
+];
+// Comprehensive list of all supported Tailwind property keys
+export const TAILWIND_PROPERTY_KEYS = [
+    // Layout
+    "display",
+    "position",
+    "top",
+    "right",
+    "bottom",
+    "left",
+    "visibility",
+    "z-index",
+    "overflow",
+    "overflow-x",
+    "overflow-y",
+    "overscroll",
+    "clear",
+    "float",
+    // Flexbox & Grid
+    "flex-direction",
+    "flex-wrap",
+    "flex",
+    "flex-grow",
+    "flex-shrink",
+    "flex-basis",
+    "order",
+    "grid-template-columns",
+    "grid-template-rows",
+    "grid-column",
+    "grid-row",
+    "grid-auto-flow",
+    "gap",
+    "gap-x",
+    "gap-y",
+    "justify",
+    "justify-items",
+    "justify-self",
+    "align-content",
+    "align-items",
+    "align-self",
+    "place-content",
+    "place-items",
+    "place-self",
+    // Spacing
+    "m",
+    "mx",
+    "my",
+    "mt",
+    "mr",
+    "mb",
+    "ml",
+    "p",
+    "px",
+    "py",
+    "pt",
+    "pr",
+    "pb",
+    "pl",
+    "space-x",
+    "space-y",
+    // Sizing
+    "width",
+    "min-width",
+    "max-width",
+    "height",
+    "min-height",
+    "max-height",
+    "size",
+    "aspect-ratio",
+    // Typography
+    "font-family",
+    "font-size",
+    "font-weight",
+    "font-style",
+    "font-variant-numeric",
+    "line-height",
+    "letter-spacing",
+    "text-align",
+    "text-color",
+    "text-shadow-size",
+    "text-shadow-color",
+    "text-decoration",
+    "text-decoration-color",
+    "text-decoration-style",
+    "text-decoration-thickness",
+    "text-underline-offset",
+    "text-transform",
+    "text-overflow",
+    "text-indent",
+    "text-balance",
+    "vertical-align",
+    "whitespace",
+    "word-break",
+    "hyphens",
+    "content",
+    "object-fit",
+    "object-position",
+    // Backgrounds
+    "background-attachment",
+    "background-clip",
+    "background-color",
+    "background-origin",
+    "background-position",
+    "background-repeat",
+    "background-size",
+    "background-image",
+    "background-gradient-from",
+    "background-gradient-via",
+    "background-gradient-to",
+    // Borders
+    ...BORDER_RADIUS_PROPERTY_KEYS,
+    ...BORDER_PROPERTY_KEYS,
+    "border-style",
+    "border-collapse",
+    "border-spacing",
+    "divide-width",
+    "divide-color",
+    "divide-style",
+    "outline-width",
+    "outline-color",
+    "outline-style",
+    "outline-offset",
+    "ring-width",
+    "ring-color",
+    "ring-opacity",
+    "ring-offset-width",
+    "ring-offset-color",
+    // Effects
+    "box-shadow",
+    "box-shadow-color",
+    "opacity",
+    "mix-blend-mode",
+    "background-blend-mode",
+    // Filters
+    "blur",
+    "brightness",
+    "contrast",
+    "drop-shadow",
+    "grayscale",
+    "hue-rotate",
+    "invert",
+    "saturate",
+    "sepia",
+    "backdrop-blur",
+    "backdrop-brightness",
+    "backdrop-contrast",
+    "backdrop-grayscale",
+    "backdrop-hue-rotate",
+    "backdrop-invert",
+    "backdrop-opacity",
+    "backdrop-saturate",
+    "backdrop-sepia",
+    // Tables
+    "border-collapse",
+    "border-spacing",
+    "table-layout",
+    "caption-side",
+    "empty-cells",
+    // Transitions & Animation
+    "transition",
+    "transition-delay",
+    "transition-duration",
+    "transition-property",
+    "transition-timing-function",
+    "duration",
+    "delay",
+    "ease",
+    "animate",
+    // Transforms
+    "scale",
+    "scale-x",
+    "scale-y",
+    "rotate",
+    "translate-x",
+    "translate-y",
+    "skew-x",
+    "skew-y",
+    "transform-origin",
+    // Interactivity
+    "accent-color",
+    "appearance",
+    "cursor",
+    "caret-color",
+    "pointer-events",
+    "resize",
+    "scroll-behavior",
+    "scroll-margin",
+    "scroll-padding",
+    "scroll-snap-align",
+    "scroll-snap-stop",
+    "scroll-snap-type",
+    "touch-action",
+    "user-select",
+    "will-change",
+    // SVG
+    "fill",
+    "stroke",
+    "stroke-width",
+    // Accessibility
+    "screen-readers",
+    // bg
+    "bg-attachment",
+    "bg-clip",
+    "bg-origin",
+    "bg-position",
+    "bg-repeat",
+    "bg-size",
+    "bg-linear",
+    "bg-radial",
+];
+//# sourceMappingURL=tailwind-property-keys.js.map

package/dist/props/tailwind-property-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-property-keys.js","sourceRoot":"","sources":["../../src/props/tailwind-property-keys.ts"],"names":[],"mappings":"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"}

package/dist/restart-contract.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Child process exit code that asks the `superblocks dev` parent supervisor to
+ * respawn the dev server in place (rather than letting the pod be swapped)
+ * after an in-place v2->v3 template flip, so the same pod boots the new
+ * template. The full exit-code contract is documented in
+ * `packages/cli/packages/cli/src/commands/dev-parent.mts`.
+ */
+export declare const RESTART_EXIT_CODE = 98;
+/**
+ * Env var the CLI parent sets on every supervised child it spawns. Its presence
+ * tells the dev-server runtime that a supervisor is watching for
+ * `RESTART_EXIT_CODE` and will respawn the child, so it is safe to self-restart
+ * in place after a template flip. Warm-claimed single-process pods have no
+ * parent loop and never see this marker, so they keep today's pod-swap behavior.
+ */
+export declare const RESTART_SUPERVISED_ENV = "SUPERBLOCKS_RESTART_SUPERVISED";
+/**
+ * Env var the CLI parent stamps on a child it respawns *because the previous
+ * child exited with `RESTART_EXIT_CODE`* (an in-place v2->v3 template flip). The
+ * respawned dev-server reads it once at boot to tag its boot metric, so Datadog
+ * can tell a post-flip in-place restart apart from a normal cold start and prove
+ * the child actually booted after the flip. Absent on a first/cold boot.
+ *
+ * Canonically defined here; the builtins-only CLI parent
+ * (`restart-template-env.mts`) keeps a hand-written copy that the drift-guard
+ * test pins to this value. Keep the two in sync.
+ */
+export declare const RESTART_REASON_ENV = "SUPERBLOCKS_RESTART_REASON";
+/**
+ * The only value the parent writes into `RESTART_REASON_ENV`: an in-place
+ * respawn after a template flip. Kept as a closed constant (not free-form text)
+ * so it can back a bounded, low-cardinality `boot_kind` metric label.
+ */
+export declare const RESTART_REASON_FLIP_RESTART = "flip_restart";
+//# sourceMappingURL=restart-contract.d.ts.map

package/dist/restart-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-contract.d.ts","sourceRoot":"","sources":["../src/restart-contract.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,mCAAmC,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,iBAAiB,CAAC"}

package/dist/restart-contract.js

@@ -0,0 +1,49 @@
+// Canonical home for the in-place dev-server restart contract — the handshake
+// between the dev-server runtime (which decides to restart and exits) and the
+// `superblocks dev` parent supervisor (which respawns the child).
+//
+// This module intentionally has ZERO imports so it can be pulled in via the
+// dedicated `@superblocksteam/library-shared/restart-contract` subpath without
+// dragging the rest of library-shared's (heavy, frontend) runtime into the
+// Node dev-server process.
+//
+// Two readers cannot import this module and keep their own annotated copies,
+// because they run in the lightweight `superblocks dev` parent which must stay
+// on `node:` builtins only (see dev-parent.mts): `RESTART_EXIT_CODE` in
+// dev-parent.mts and `RESTART_SUPERVISED_ENV` in restart-template-env.mts. Those
+// copies point back here as the source of truth; keep them in sync.
+/**
+ * Child process exit code that asks the `superblocks dev` parent supervisor to
+ * respawn the dev server in place (rather than letting the pod be swapped)
+ * after an in-place v2->v3 template flip, so the same pod boots the new
+ * template. The full exit-code contract is documented in
+ * `packages/cli/packages/cli/src/commands/dev-parent.mts`.
+ */
+export const RESTART_EXIT_CODE = 98;
+/**
+ * Env var the CLI parent sets on every supervised child it spawns. Its presence
+ * tells the dev-server runtime that a supervisor is watching for
+ * `RESTART_EXIT_CODE` and will respawn the child, so it is safe to self-restart
+ * in place after a template flip. Warm-claimed single-process pods have no
+ * parent loop and never see this marker, so they keep today's pod-swap behavior.
+ */
+export const RESTART_SUPERVISED_ENV = "SUPERBLOCKS_RESTART_SUPERVISED";
+/**
+ * Env var the CLI parent stamps on a child it respawns *because the previous
+ * child exited with `RESTART_EXIT_CODE`* (an in-place v2->v3 template flip). The
+ * respawned dev-server reads it once at boot to tag its boot metric, so Datadog
+ * can tell a post-flip in-place restart apart from a normal cold start and prove
+ * the child actually booted after the flip. Absent on a first/cold boot.
+ *
+ * Canonically defined here; the builtins-only CLI parent
+ * (`restart-template-env.mts`) keeps a hand-written copy that the drift-guard
+ * test pins to this value. Keep the two in sync.
+ */
+export const RESTART_REASON_ENV = "SUPERBLOCKS_RESTART_REASON";
+/**
+ * The only value the parent writes into `RESTART_REASON_ENV`: an in-place
+ * respawn after a template flip. Kept as a closed constant (not free-form text)
+ * so it can back a bounded, low-cardinality `boot_kind` metric label.
+ */
+export const RESTART_REASON_FLIP_RESTART = "flip_restart";
+//# sourceMappingURL=restart-contract.js.map

package/dist/restart-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-contract.js","sourceRoot":"","sources":["../src/restart-contract.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,2BAA2B;AAC3B,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,wEAAwE;AACxE,iFAAiF;AACjF,oEAAoE;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,cAAc,CAAC"}

package/dist/scope.d.ts

@@ -1,2 +1,4 @@
+import type { SbElement } from "./types/common.js";
 export declare function getStableScopeId(scopeName: string): string;
+export declare function getStableEntityId(scopeId: string, entityName: string): SbElement;
 //# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,UAEjD"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,UAEjD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GACA,SAAS,CAC7E"}

package/dist/scope.js

@@ -2,4 +2,7 @@ import { generatePredictableId } from "@superblocksteam/shared";
 export function getStableScopeId(scopeName) {
     return generatePredictableId(`sc-${scopeName}`);
 }
+export function getStableEntityId(scopeId, entityName) {
+    return `SB-${generatePredictableId(scopeId + entityName)}-type`;
+}
 //# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,qBAAqB,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,qBAAqB,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,UAAkB;IACnE,OAAO,MAAM,qBAAqB,CAAC,OAAO,GAAG,UAAU,CAAC,OAAoB,CAAC;AAC/E,CAAC"}

package/dist/testing/default-structure-scope/index.d.ts

@@ -0,0 +1,8 @@
+import type { Node } from "../../pages.js";
+import type { AppScope } from "../../types/scope.js";
+/**
+ * The scope a freshly created app boots with: one empty page and an app root
+ * holding a bare Outlet.
+ */
+export declare function defaultStructureScope(pageChildren?: Node[]): AppScope;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/default-structure-scope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/default-structure-scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,GAAE,IAAI,EAAO,GAAG,QAAQ,CAwDzE"}

package/dist/testing/default-structure-scope/index.js

@@ -0,0 +1,62 @@
+/**
+ * The scope a freshly created app boots with: one empty page and an app root
+ * holding a bare Outlet.
+ */
+export function defaultStructureScope(pageChildren = []) {
+    return {
+        entities: {},
+        pages: {
+            Home: {
+                entities: {},
+                name: "Home",
+                roots: [
+                    {
+                        id: "page-root",
+                        kind: "page",
+                        name: "Home",
+                        root: {
+                            children: pageChildren,
+                            id: "page",
+                            name: "Home",
+                            properties: {},
+                            tagName: "div",
+                            type: "WidgetNode",
+                        },
+                        type: "RootNode",
+                    },
+                ],
+                routes: ["/"],
+                scopeId: "home",
+                scopeName: "Home",
+            },
+        },
+        roots: [
+            {
+                id: "app-root",
+                kind: "app",
+                name: "App",
+                root: {
+                    children: [
+                        {
+                            children: [],
+                            id: "outlet",
+                            name: "Outlet",
+                            properties: {},
+                            tagName: "Outlet",
+                            type: "WidgetNode",
+                        },
+                    ],
+                    id: "app",
+                    name: "App",
+                    properties: {},
+                    tagName: "div",
+                    type: "WidgetNode",
+                },
+                type: "RootNode",
+            },
+        ],
+        scopeId: "app",
+        scopeName: "App",
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/default-structure-scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/default-structure-scope/index.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,eAAuB,EAAE;IAC7D,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,QAAQ,EAAE,EAAE;gBACZ,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL;wBACE,EAAE,EAAE,WAAW;wBACf,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;4BACJ,QAAQ,EAAE,YAAY;4BACtB,EAAE,EAAE,MAAM;4BACV,IAAI,EAAE,MAAM;4BACZ,UAAU,EAAE,EAAE;4BACd,OAAO,EAAE,KAAK;4BACd,IAAI,EAAE,YAAY;yBACnB;wBACD,IAAI,EAAE,UAAU;qBACjB;iBACF;gBACD,MAAM,EAAE,CAAC,GAAG,CAAC;gBACb,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,MAAM;aAClB;SACF;QACD,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE;oBACJ,QAAQ,EAAE;wBACR;4BACE,QAAQ,EAAE,EAAE;4BACZ,EAAE,EAAE,QAAQ;4BACZ,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE,EAAE;4BACd,OAAO,EAAE,QAAQ;4BACjB,IAAI,EAAE,YAAY;yBACnB;qBACF;oBACD,EAAE,EAAE,KAAK;oBACT,IAAI,EAAE,KAAK;oBACX,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE,YAAY;iBACnB;gBACD,IAAI,EAAE,UAAU;aACjB;SACF;QACD,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC"}

package/dist/testing/fake-editor-channel/fake-artifact.d.ts

@@ -0,0 +1,41 @@
+import type { ServerMethods } from "../../types/socket.js";
+/**
+ * Lifecycle of the fake app artifact behind draft accept/reject:
+ * `pending` (Clark finished a turn and left a draft), `unpublished`
+ * (the draft was accepted into a checkpoint), `published` (no draft;
+ * the editor shows the last published state).
+ */
+export type FakeArtifactState = "pending" | "unpublished" | "published";
+type DraftDecisionHandlers = {
+    aiAcceptDraft: ServerMethods["editor"]["aiAcceptDraft"];
+    aiRejectDraft: ServerMethods["editor"]["aiRejectDraft"];
+};
+/**
+ * In-memory stand-in for the app artifact that draft accept/reject
+ * operates on, per the Versions UX row of the Editor UX Surfaces
+ * testability table: state toggles pending -> unpublished on accept and
+ * pending -> published on reject, readable by tests via `state`.
+ *
+ * The channel stays strict: spread `handlers` into the
+ * `FakeEditorChannel` constructor's `serverHandlers` to bind the draft
+ * decision methods, e.g.
+ * `new FakeEditorChannel({ serverHandlers: { ...artifact.handlers } })`.
+ * Accept on a non-pending artifact rejects, so a test that double-fires
+ * accept fails loudly instead of minting a second commit id.
+ */
+export declare class FakeArtifact {
+    private nextCommitId;
+    private stateValue;
+    constructor(initialState?: FakeArtifactState);
+    get state(): FakeArtifactState;
+    /**
+     * Models the out-of-band event of Clark finishing a turn with file
+     * changes: draft creation is not a wire method on this channel, so
+     * tests stage a new draft here. Besides the constructor's
+     * initialState, this is the only way to reach `pending`.
+     */
+    stageDraft(): void;
+    readonly handlers: DraftDecisionHandlers;
+}
+export {};
+//# sourceMappingURL=fake-artifact.d.ts.map

package/dist/testing/fake-editor-channel/fake-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-artifact.d.ts","sourceRoot":"","sources":["../../../src/testing/fake-editor-channel/fake-artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAExE,KAAK,qBAAqB,GAAG;IAC3B,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC;IACxD,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC;CACzD,CAAC;AAuBF;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAoB;gBAE1B,YAAY,GAAE,iBAA+B;IAIzD,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED;;;;;OAKG;IACH,UAAU,IAAI,IAAI;IAIlB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAsBtC;CACH"}

package/dist/testing/fake-editor-channel/fake-artifact.js

@@ -0,0 +1,74 @@
+/**
+ * A real remote handler failure never reaches the caller as an Error
+ * instance: the socket serializes it to `{ code, message, stack }` with
+ * code 3, and the caller's promise rejects with that parsed plain
+ * object. Reject with the same shape so tests see production semantics.
+ *
+ * Distinct from the channel's remoteHandlerError on purpose: that helper
+ * models a thrown SocketErrorException, whose message crosses verbatim,
+ * while this models a handler throwing a plain Error, which the socket
+ * stringifies to an "Error: "-prefixed message. Production produces both
+ * shapes, one per path.
+ */
+const remoteFailure = (message) => {
+    const error = new Error(message);
+    return Promise.reject({
+        code: 3,
+        message: error.toString(),
+        stack: error.stack,
+    });
+};
+/**
+ * In-memory stand-in for the app artifact that draft accept/reject
+ * operates on, per the Versions UX row of the Editor UX Surfaces
+ * testability table: state toggles pending -> unpublished on accept and
+ * pending -> published on reject, readable by tests via `state`.
+ *
+ * The channel stays strict: spread `handlers` into the
+ * `FakeEditorChannel` constructor's `serverHandlers` to bind the draft
+ * decision methods, e.g.
+ * `new FakeEditorChannel({ serverHandlers: { ...artifact.handlers } })`.
+ * Accept on a non-pending artifact rejects, so a test that double-fires
+ * accept fails loudly instead of minting a second commit id.
+ */
+export class FakeArtifact {
+    nextCommitId = 1;
+    stateValue;
+    constructor(initialState = "published") {
+        this.stateValue = initialState;
+    }
+    get state() {
+        return this.stateValue;
+    }
+    /**
+     * Models the out-of-band event of Clark finishing a turn with file
+     * changes: draft creation is not a wire method on this channel, so
+     * tests stage a new draft here. Besides the constructor's
+     * initialState, this is the only way to reach `pending`.
+     */
+    stageDraft() {
+        this.stateValue = "pending";
+    }
+    handlers = {
+        aiAcceptDraft: async () => {
+            if (this.stateValue !== "pending") {
+                return remoteFailure(`Fake artifact has no pending draft to accept (state: ${this.stateValue})`);
+            }
+            this.stateValue = "unpublished";
+            const commitId = `fake-commit-${this.nextCommitId}`;
+            this.nextCommitId += 1;
+            return { commitId };
+        },
+        // The editor's restore flow fires aiRejectDraft as cleanup even when
+        // no draft is pending, so a non-pending reject resolves as a no-op
+        // instead of throwing. Only pending -> published is a real discard;
+        // leaving other states untouched keeps a discard-after-accept bug
+        // visible to tests instead of masking it as "published".
+        aiRejectDraft: async () => {
+            if (this.stateValue === "pending") {
+                this.stateValue = "published";
+            }
+        },
+    };
+}
+//# sourceMappingURL=fake-artifact.js.map

package/dist/testing/fake-editor-channel/fake-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-artifact.js","sourceRoot":"","sources":["../../../src/testing/fake-editor-channel/fake-artifact.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;GAWG;AACH,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE;IACxC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IACf,YAAY,GAAG,CAAC,CAAC;IACjB,UAAU,CAAoB;IAEtC,YAAY,eAAkC,WAAW;QACvD,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC;IACjC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAEQ,QAAQ,GAA0B;QACzC,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAClC,OAAO,aAAa,CAClB,wDAAwD,IAAI,CAAC,UAAU,GAAG,CAC3E,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC;YAChC,MAAM,QAAQ,GAAG,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC;YACpD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;QACD,qEAAqE;QACrE,mEAAmE;QACnE,oEAAoE;QACpE,kEAAkE;QAClE,yDAAyD;QACzD,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC;YAChC,CAAC;QACH,CAAC;KACF,CAAC;CACH"}