cursedbelt 2.8.0 → 3.0.0

package/dist/studio/operations.d.ts

@@ -1,173 +0,0 @@
-/**
- * The studio's edit operations (03 §3) — every canvas gesture, as a pure
- * function `StudioDesign → StudioDesign`.
- *
- * ## Why these are functions and not setState calls in a component
- *
- * The §3 gates are "a design round-trips through the pipeline" and "an edit that
- * breaks a cross-engine rule cannot be saved". Both are statements about the
- * DOCUMENT, and neither is testable if the only way to make an edit is to render
- * a canvas and synthesize a drag. Keeping the transitions here makes the whole
- * editor provable at the cost of one indirection.
- *
- * ## The invariant every operation upholds
- *
- * **An edit never leaves a reference dangling that the author did not touch.**
- * Deleting an instance drops the wires into and out of it; renaming one rewrites
- * them (and carries its canvas position). The pipeline would of course CATCH a
- * dangling wire — `unknown-connection-endpoint` is an error — but a diagnostic
- * for a wire the author never drew is the editor blaming them for its own
- * bookkeeping, and after the second one they stop reading the panel.
- *
- * What operations deliberately do NOT do is pre-validate. `setFeature` will
- * happily turn on `privateMedia` without the guard engine, because showing the
- * author the `engine-dependency-missing` diagnostic inline (and refusing the
- * SAVE) is the specified behavior — a control that silently refuses to move
- * teaches nothing.
- */
-import type { EngineId } from '../config/appConfig';
-import type { DraftConfig, DraftInstance, NodePosition, NodeSize, StudioDesign } from './document';
-type Routes = NonNullable<DraftInstance['routes']>;
-type Fills = NonNullable<DraftInstance['fills']>;
-export declare function setAppMeta(design: StudioDesign, patch: Partial<DraftConfig['app']>): StudioDesign;
-/**
- * Switch profile. Moving to `saas` brings the guard engine and `rbac: true` with
- * it, because V0 structurally requires both — flipping a radio into a state the
- * compiler forbids, and then reporting two errors the author cannot act on
- * without knowing the rule, is a worse teacher than just doing the implied
- * thing. (An author who wants saas WITHOUT guard is asking for a config that
- * cannot exist; the pipeline still says so if they undo the additions.)
- */
-export declare function setProfile(design: StudioDesign, profile: 'local' | 'saas'): StudioDesign;
-export declare function setAuthEnabled(design: StudioDesign, enabled: boolean): StudioDesign;
-export declare function setTheme(design: StudioDesign, patch: {
-    preset?: string;
-    overrides?: Record<string, string>;
-}): StudioDesign;
-/**
- * Deactivate an engine. Its instances go with it — an instance whose engine is
- * not in `engines[]` is an error at V0, so leaving them behind would turn one
- * gesture into N diagnostics about nodes still sitting on the canvas.
- */
-export declare function deactivateEngine(design: StudioDesign, engine: EngineId): StudioDesign;
-/**
- * Drop a node on the canvas. Activates the engine if it is not already active:
- * the alternative is that dragging an engine onto the canvas produces an
- * instant `engine-dependency-missing` and a second, separate gesture to clear
- * it, for a config state nobody ever wants.
- */
-export declare function addInstance(design: StudioDesign, engine: EngineId, options?: {
-    id?: string;
-    title?: string;
-    features?: Record<string, unknown>;
-    position?: NodePosition;
-}): StudioDesign;
-/**
- * Delete a node, and with it every wire that touched it and its stored position.
- *
- * The engine stays active even when this was its last instance. That is
- * deliberate: `engines[]` is the author's declaration of what the app is made
- * of, and silently un-declaring an engine because a node was deleted would make
- * a delete-then-re-add round trip lossy in a way nothing on screen explains.
- */
-export declare function removeInstance(design: StudioDesign, id: string): StudioDesign;
-/**
- * Rename a node. Rewrites every wire endpoint that named it and carries its
- * canvas position across — a rename that teleports the node to its auto-layout
- * slot is the kind of small wrongness that makes a builder feel unfinished.
- *
- * Refuses a collision rather than merging two instances into one id.
- */
-export declare function renameInstance(design: StudioDesign, from: string, to: string): StudioDesign;
-/**
- * Swap the node at `currentId` for a fresh instance of `engine`, in place.
- *
- * This is the "View / tinker" gesture: one node under the cursor, and picking a
- * different engine REPLACES it rather than adding a second — the whole point of
- * the mode that hosts this. It is one operation, so the whole swap is a single
- * undo step (delete + add would be two, and undoing a tinker should not take two
- * presses).
- *
- * **Position is preserved.** The incoming node inherits the outgoing node's
- * RESOLVED position (stored where it was dragged, its auto-layout slot
- * otherwise), pinned as a stored position so it lands exactly where the old one
- * sat — a different engine auto-lays-out to a different column, so without this
- * the "replace" would teleport the node across the canvas.
- *
- * **The old engine goes with its last instance.** Unlike a plain delete — which
- * keeps the engine active so a delete/re-add round trip is lossless — a replace
- * is a swap: if the outgoing node was the last instance of its engine, that
- * engine is deactivated too, so the palette does not keep showing an engine the
- * author just swapped away as active-with-zero-instances.
- *
- * **Wire policy — every wire that touched the outgoing node is DROPPED**, exactly
- * as {@link removeInstance} drops them. It is tempting to "keep the compatible
- * ones", but which ports the INCOMING node exposes is a function of the new
- * engine's catalog AND its (now default) features AND the host's capabilities —
- * the post-V2 materialized manifest, not anything a pure `StudioDesign →
- * StudioDesign` transition can see. A wire re-pointed onto a port the new node
- * does not actually materialize is not a dangling ref this function can detect;
- * it is a live `unknown-connection-endpoint` / mode-mismatch that BLOCKS the save
- * — the precise red gate a "helpful" re-point would introduce. Dropping is the
- * only policy that provably never dangles and never turns the pipeline red; the
- * canvas only ever offered legal drops, so the author redraws against the new
- * node's live ports in the same gesture they already know.
- *
- * With nothing at `currentId` (an empty canvas, or a stale id), this is a plain
- * {@link addInstance} — "replace nothing" is "add".
- */
-export declare function replaceInstance(design: StudioDesign, currentId: string, engine: EngineId, options?: {
-    id?: string;
-    title?: string;
-    features?: Record<string, unknown>;
-}): StudioDesign;
-export declare function setInstanceTitle(design: StudioDesign, id: string, title: string): StudioDesign;
-export declare function setCssIsolation(design: StudioDesign, id: string, cssIsolation: NonNullable<DraftInstance['cssIsolation']>): StudioDesign;
-/**
- * Set one feature value from the inspector.
- *
- * `undefined` REMOVES the key rather than storing `undefined`: a config is JSON,
- * and `{"gallery": undefined}` serializes to `{}` anyway — storing it would make
- * the in-memory document and the file on disk disagree about whether the author
- * had touched the field, which the round-trip gate would then catch as drift.
- */
-export declare function setFeature(design: StudioDesign, id: string, key: string, value: unknown): StudioDesign;
-/** Set an engine-specific option (the non-feature half of an instance's config). */
-export declare function setOption(design: StudioDesign, id: string, key: string, value: unknown): StudioDesign;
-/**
- * Draw a wire. Duplicates are refused (the same pair twice is not two wires, and
- * the second would only produce a confusing pair of identical diagnostics).
- * Whether the wire is LEGAL is V1/V3's answer, not this function's — see
- * `wiring.ts`, which the canvas uses to avoid offering illegal drops in the
- * first place.
- */
-export declare function addConnection(design: StudioDesign, from: string, to: string, options?: {
-    cyclic?: boolean;
-}): StudioDesign;
-export declare function removeConnection(design: StudioDesign, index: number): StudioDesign;
-/** Mark a wire as an intentional cycle — V4's `cycle-unmarked` is cleared by this. */
-export declare function setConnectionCyclic(design: StudioDesign, index: number, cyclic: boolean): StudioDesign;
-export declare function addRoute(design: StudioDesign, id: string, route: Routes[number]): StudioDesign;
-export declare function updateRoute(design: StudioDesign, id: string, index: number, patch: Partial<Routes[number]>): StudioDesign;
-export declare function removeRoute(design: StudioDesign, id: string, index: number): StudioDesign;
-export declare function addFill(design: StudioDesign, id: string, fill: Fills[number]): StudioDesign;
-export declare function removeFill(design: StudioDesign, id: string, index: number): StudioDesign;
-/** Drag a node. Layout only — never touches the config, so a re-layout produces
- *  no diff in `app-config.json` and no re-verify. */
-export declare function moveNode(design: StudioDesign, id: string, position: NodePosition): StudioDesign;
-/**
- * Resize a node. Layout only, exactly like {@link moveNode} — a box is editor
- * state, never a config byte. Storing a size is what pins it as a MANUAL resize
- * that wins over the canvas's auto-size measurement from then on.
- *
- * The size is clamped to the {@link MIN_NODE_WIDTH}/{@link MIN_NODE_HEIGHT}
- * floor here, in the pure op, so every path into a resize (pointer, keyboard, a
- * host restoring one off disk) lands the same guarantee — a node too small to
- * read its own label is not representable in the document.
- */
-export declare function resizeNode(design: StudioDesign, id: string, size: NodeSize): StudioDesign;
-/** Forget every stored position AND size, falling back to the deterministic
- *  auto-layout and the auto-size default. */
-export declare function resetLayout(design: StudioDesign): StudioDesign;
-export {};
-//# sourceMappingURL=operations.d.ts.map

package/dist/studio/operations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/studio/operations.ts"],"names":[],"mappings":"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"}

package/dist/studio/operations.js

@@ -1,332 +0,0 @@
-import { MIN_NODE_HEIGHT, MIN_NODE_WIDTH, nextInstanceId, resolvedPositions } from './document';
-const instancesOf = (config) => config.instances ?? [];
-const connectionsOf = (config) => config.connections ?? [];
-/** Replace the config, keeping the layout. */
-const withConfig = (design, config) => ({ ...design, config });
-/** Rewrite one instance in place, by id. A miss returns the design untouched —
- *  an edit racing a delete is a no-op, not a crash. */
-function mapInstance(design, id, update) {
-    const instances = instancesOf(design.config);
-    if (!instances.some((instance) => instance.id === id))
-        return design;
-    return withConfig(design, {
-        ...design.config,
-        instances: instances.map((instance) => (instance.id === id ? update(instance) : instance)),
-    });
-}
-/** The instance id half of a `'<instanceId>:<portId>'` endpoint. `data:` sources
- *  have no instance and are never rewritten by an instance operation. */
-const endpointInstance = (endpoint) => {
-    const head = endpoint.slice(0, endpoint.indexOf(':'));
-    return head === 'data' || head === '' ? null : head;
-};
-/* ------------------------------------------------------------- app & engines */
-export function setAppMeta(design, patch) {
-    return withConfig(design, { ...design.config, app: { ...design.config.app, ...patch } });
-}
-/**
- * Switch profile. Moving to `saas` brings the guard engine and `rbac: true` with
- * it, because V0 structurally requires both — flipping a radio into a state the
- * compiler forbids, and then reporting two errors the author cannot act on
- * without knowing the rule, is a worse teacher than just doing the implied
- * thing. (An author who wants saas WITHOUT guard is asking for a config that
- * cannot exist; the pipeline still says so if they undo the additions.)
- */
-export function setProfile(design, profile) {
-    if (profile !== 'saas')
-        return withConfig(design, { ...design.config, profile });
-    let next = withConfig(design, { ...design.config, profile });
-    if (!(next.config.engines ?? []).includes('guard'))
-        next = addInstance(next, 'guard');
-    const guard = instancesOf(next.config).find((instance) => instance.engine === 'guard');
-    return guard ? setFeature(next, guard.id, 'rbac', true) : next;
-}
-export function setAuthEnabled(design, enabled) {
-    const auth = design.config.auth ?? {};
-    return withConfig(design, { ...design.config, auth: { ...auth, enabled } });
-}
-export function setTheme(design, patch) {
-    return withConfig(design, { ...design.config, theme: { ...(design.config.theme ?? {}), ...patch } });
-}
-/**
- * Deactivate an engine. Its instances go with it — an instance whose engine is
- * not in `engines[]` is an error at V0, so leaving them behind would turn one
- * gesture into N diagnostics about nodes still sitting on the canvas.
- */
-export function deactivateEngine(design, engine) {
-    let next = design;
-    for (const instance of instancesOf(design.config).filter((i) => i.engine === engine)) {
-        next = removeInstance(next, instance.id);
-    }
-    return withConfig(next, {
-        ...next.config,
-        engines: (next.config.engines ?? []).filter((id) => id !== engine),
-    });
-}
-/* ---------------------------------------------------------------- instances */
-/**
- * Drop a node on the canvas. Activates the engine if it is not already active:
- * the alternative is that dragging an engine onto the canvas produces an
- * instant `engine-dependency-missing` and a second, separate gesture to clear
- * it, for a config state nobody ever wants.
- */
-export function addInstance(design, engine, options) {
-    const id = options?.id ?? nextInstanceId(design.config, engine);
-    const instance = {
-        engine,
-        id,
-        ...(options?.title === undefined ? {} : { title: options.title }),
-        features: options?.features ?? {},
-    };
-    const engines = design.config.engines ?? [];
-    return {
-        config: {
-            ...design.config,
-            engines: engines.includes(engine) ? engines : [...engines, engine],
-            instances: [...instancesOf(design.config), instance],
-        },
-        layout: options?.position
-            ? { ...design.layout, nodes: { ...design.layout.nodes, [id]: options.position } }
-            : design.layout,
-    };
-}
-/**
- * Delete a node, and with it every wire that touched it and its stored position.
- *
- * The engine stays active even when this was its last instance. That is
- * deliberate: `engines[]` is the author's declaration of what the app is made
- * of, and silently un-declaring an engine because a node was deleted would make
- * a delete-then-re-add round trip lossy in a way nothing on screen explains.
- */
-export function removeInstance(design, id) {
-    const instances = instancesOf(design.config).filter((instance) => instance.id !== id);
-    if (instances.length === instancesOf(design.config).length)
-        return design;
-    const connections = connectionsOf(design.config).filter((wire) => endpointInstance(wire.from) !== id && endpointInstance(wire.to) !== id);
-    const { [id]: _droppedNode, ...nodes } = design.layout.nodes;
-    const { [id]: _droppedSize, ...sizes } = design.layout.sizes;
-    return { config: { ...design.config, instances, connections }, layout: { nodes, sizes } };
-}
-/**
- * Rename a node. Rewrites every wire endpoint that named it and carries its
- * canvas position across — a rename that teleports the node to its auto-layout
- * slot is the kind of small wrongness that makes a builder feel unfinished.
- *
- * Refuses a collision rather than merging two instances into one id.
- */
-export function renameInstance(design, from, to) {
-    if (from === to)
-        return design;
-    const instances = instancesOf(design.config);
-    if (!instances.some((instance) => instance.id === from))
-        return design;
-    if (instances.some((instance) => instance.id === to))
-        return design;
-    const rewrite = (endpoint) => {
-        const head = endpointInstance(endpoint);
-        return head === from ? `${to}${endpoint.slice(from.length)}` : endpoint;
-    };
-    const { [from]: movedNode, ...nodes } = design.layout.nodes;
-    const { [from]: movedSize, ...sizes } = design.layout.sizes;
-    return {
-        config: {
-            ...design.config,
-            instances: instances.map((instance) => (instance.id === from ? { ...instance, id: to } : instance)),
-            connections: connectionsOf(design.config).map((wire) => ({
-                ...wire,
-                from: rewrite(wire.from),
-                to: rewrite(wire.to),
-            })),
-        },
-        layout: {
-            nodes: movedNode ? { ...nodes, [to]: movedNode } : nodes,
-            sizes: movedSize ? { ...sizes, [to]: movedSize } : sizes,
-        },
-    };
-}
-/**
- * Swap the node at `currentId` for a fresh instance of `engine`, in place.
- *
- * This is the "View / tinker" gesture: one node under the cursor, and picking a
- * different engine REPLACES it rather than adding a second — the whole point of
- * the mode that hosts this. It is one operation, so the whole swap is a single
- * undo step (delete + add would be two, and undoing a tinker should not take two
- * presses).
- *
- * **Position is preserved.** The incoming node inherits the outgoing node's
- * RESOLVED position (stored where it was dragged, its auto-layout slot
- * otherwise), pinned as a stored position so it lands exactly where the old one
- * sat — a different engine auto-lays-out to a different column, so without this
- * the "replace" would teleport the node across the canvas.
- *
- * **The old engine goes with its last instance.** Unlike a plain delete — which
- * keeps the engine active so a delete/re-add round trip is lossless — a replace
- * is a swap: if the outgoing node was the last instance of its engine, that
- * engine is deactivated too, so the palette does not keep showing an engine the
- * author just swapped away as active-with-zero-instances.
- *
- * **Wire policy — every wire that touched the outgoing node is DROPPED**, exactly
- * as {@link removeInstance} drops them. It is tempting to "keep the compatible
- * ones", but which ports the INCOMING node exposes is a function of the new
- * engine's catalog AND its (now default) features AND the host's capabilities —
- * the post-V2 materialized manifest, not anything a pure `StudioDesign →
- * StudioDesign` transition can see. A wire re-pointed onto a port the new node
- * does not actually materialize is not a dangling ref this function can detect;
- * it is a live `unknown-connection-endpoint` / mode-mismatch that BLOCKS the save
- * — the precise red gate a "helpful" re-point would introduce. Dropping is the
- * only policy that provably never dangles and never turns the pipeline red; the
- * canvas only ever offered legal drops, so the author redraws against the new
- * node's live ports in the same gesture they already know.
- *
- * With nothing at `currentId` (an empty canvas, or a stale id), this is a plain
- * {@link addInstance} — "replace nothing" is "add".
- */
-export function replaceInstance(design, currentId, engine, options) {
-    const current = instancesOf(design.config).find((instance) => instance.id === currentId);
-    if (!current)
-        return addInstance(design, engine, options);
-    // Capture the outgoing node's on-canvas home BEFORE the delete forgets it.
-    const position = resolvedPositions(design)[currentId];
-    let next = removeInstance(design, currentId);
-    // A replace is a swap, not a delete: retire the emptied old engine (never the
-    // one we are about to add back).
-    if (current.engine !== engine && !instancesOf(next.config).some((instance) => instance.engine === current.engine)) {
-        next = withConfig(next, {
-            ...next.config,
-            engines: (next.config.engines ?? []).filter((id) => id !== current.engine),
-        });
-    }
-    return addInstance(next, engine, { ...options, ...(position ? { position } : {}) });
-}
-export function setInstanceTitle(design, id, title) {
-    return mapInstance(design, id, (instance) => {
-        if (title.length > 0)
-            return { ...instance, title };
-        const { title: _dropped, ...rest } = instance;
-        return rest;
-    });
-}
-export function setCssIsolation(design, id, cssIsolation) {
-    return mapInstance(design, id, (instance) => ({ ...instance, cssIsolation }));
-}
-/**
- * Set one feature value from the inspector.
- *
- * `undefined` REMOVES the key rather than storing `undefined`: a config is JSON,
- * and `{"gallery": undefined}` serializes to `{}` anyway — storing it would make
- * the in-memory document and the file on disk disagree about whether the author
- * had touched the field, which the round-trip gate would then catch as drift.
- */
-export function setFeature(design, id, key, value) {
-    return mapInstance(design, id, (instance) => {
-        const features = { ...(instance.features ?? {}) };
-        if (value === undefined)
-            delete features[key];
-        else
-            features[key] = value;
-        return { ...instance, features };
-    });
-}
-/** Set an engine-specific option (the non-feature half of an instance's config). */
-export function setOption(design, id, key, value) {
-    return mapInstance(design, id, (instance) => {
-        const options = { ...(instance.options ?? {}) };
-        if (value === undefined)
-            delete options[key];
-        else
-            options[key] = value;
-        return { ...instance, options };
-    });
-}
-/* ------------------------------------------------------------------- wires */
-/**
- * Draw a wire. Duplicates are refused (the same pair twice is not two wires, and
- * the second would only produce a confusing pair of identical diagnostics).
- * Whether the wire is LEGAL is V1/V3's answer, not this function's — see
- * `wiring.ts`, which the canvas uses to avoid offering illegal drops in the
- * first place.
- */
-export function addConnection(design, from, to, options) {
-    const connections = connectionsOf(design.config);
-    if (connections.some((wire) => wire.from === from && wire.to === to))
-        return design;
-    return withConfig(design, {
-        ...design.config,
-        connections: [...connections, { from, to, ...(options?.cyclic ? { cyclic: true } : {}) }],
-    });
-}
-export function removeConnection(design, index) {
-    const connections = connectionsOf(design.config);
-    if (index < 0 || index >= connections.length)
-        return design;
-    return withConfig(design, { ...design.config, connections: connections.filter((_, i) => i !== index) });
-}
-/** Mark a wire as an intentional cycle — V4's `cycle-unmarked` is cleared by this. */
-export function setConnectionCyclic(design, index, cyclic) {
-    const connections = connectionsOf(design.config);
-    if (index < 0 || index >= connections.length)
-        return design;
-    return withConfig(design, {
-        ...design.config,
-        connections: connections.map((wire, i) => (i === index ? { ...wire, cyclic } : wire)),
-    });
-}
-/* --------------------------------------------------------- routes and fills */
-export function addRoute(design, id, route) {
-    return mapInstance(design, id, (instance) => ({ ...instance, routes: [...(instance.routes ?? []), route] }));
-}
-export function updateRoute(design, id, index, patch) {
-    return mapInstance(design, id, (instance) => {
-        const routes = instance.routes ?? [];
-        if (index < 0 || index >= routes.length)
-            return instance;
-        return { ...instance, routes: routes.map((route, i) => (i === index ? { ...route, ...patch } : route)) };
-    });
-}
-export function removeRoute(design, id, index) {
-    return mapInstance(design, id, (instance) => ({
-        ...instance,
-        routes: (instance.routes ?? []).filter((_, i) => i !== index),
-    }));
-}
-export function addFill(design, id, fill) {
-    return mapInstance(design, id, (instance) => ({ ...instance, fills: [...(instance.fills ?? []), fill] }));
-}
-export function removeFill(design, id, index) {
-    return mapInstance(design, id, (instance) => ({
-        ...instance,
-        fills: (instance.fills ?? []).filter((_, i) => i !== index),
-    }));
-}
-/* ------------------------------------------------------------------ canvas */
-/** Drag a node. Layout only — never touches the config, so a re-layout produces
- *  no diff in `app-config.json` and no re-verify. */
-export function moveNode(design, id, position) {
-    return { ...design, layout: { ...design.layout, nodes: { ...design.layout.nodes, [id]: position } } };
-}
-/**
- * Resize a node. Layout only, exactly like {@link moveNode} — a box is editor
- * state, never a config byte. Storing a size is what pins it as a MANUAL resize
- * that wins over the canvas's auto-size measurement from then on.
- *
- * The size is clamped to the {@link MIN_NODE_WIDTH}/{@link MIN_NODE_HEIGHT}
- * floor here, in the pure op, so every path into a resize (pointer, keyboard, a
- * host restoring one off disk) lands the same guarantee — a node too small to
- * read its own label is not representable in the document.
- */
-export function resizeNode(design, id, size) {
-    const clamped = {
-        width: Math.max(MIN_NODE_WIDTH, Math.round(size.width)),
-        height: Math.max(MIN_NODE_HEIGHT, Math.round(size.height)),
-    };
-    const current = design.layout.sizes[id];
-    if (current && current.width === clamped.width && current.height === clamped.height)
-        return design;
-    return { ...design, layout: { ...design.layout, sizes: { ...design.layout.sizes, [id]: clamped } } };
-}
-/** Forget every stored position AND size, falling back to the deterministic
- *  auto-layout and the auto-size default. */
-export function resetLayout(design) {
-    return { ...design, layout: { nodes: {}, sizes: {} } };
-}
-//# sourceMappingURL=operations.js.map

package/dist/studio/operations.js.map

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

package/dist/studio/session.d.ts

@@ -1,59 +0,0 @@
-import type { EffectiveManifest } from '../verify/types';
-import type { StudioDesign } from './document';
-import { type SaveDisposition, type StudioVerification, type StudioVerifyOptions } from './verification';
-export interface StudioSessionState {
-    design: StudioDesign;
-    /** Verification of the CURRENT design; null until the first run lands. */
-    verification: StudioVerification | null;
-    /**
-     * The most recent manifest that compiled — what the canvas draws ports and
-     * wires from. Survives an edit that does not compile.
-     */
-    lastGoodManifest: EffectiveManifest | null;
-    /** A compilation for the current design has not landed yet. */
-    verifying: boolean;
-    /** Bumps on every edit. Exposed so a consumer can key a render or a request. */
-    revision: number;
-    /** An earlier design can be restored (the undo stack is non-empty). */
-    canUndo: boolean;
-    /** A design undone past can be reapplied (the redo stack is non-empty). */
-    canRedo: boolean;
-}
-export type StudioEdit = (design: StudioDesign) => StudioDesign;
-export interface StudioSessionOptions extends StudioVerifyOptions {
-    design: StudioDesign;
-    /** Injected for tests and for a host that wants to compile out of process. */
-    verify?: (design: StudioDesign, options: StudioVerifyOptions) => Promise<StudioVerification>;
-}
-export interface StudioSession {
-    getState(): StudioSessionState;
-    /** Subscribe to state changes. Returns the unsubscribe. */
-    subscribe(listener: (state: StudioSessionState) => void): () => void;
-    /** Apply an edit. Synchronous: the new design is readable immediately, and a
-     *  compilation for it is scheduled. The optional `tag` coalesces consecutive
-     *  same-tag edits (a drag gesture, a burst of keystrokes) into ONE undo step —
-     *  passing no tag makes the edit its own discrete step. */
-    apply(edit: StudioEdit, tag?: string | null): StudioSessionState;
-    /** Restore the design before the last edit (no-op with nothing to undo). The
-     *  restored design re-verifies exactly as a fresh edit would. */
-    undo(): StudioSessionState;
-    /** Reapply the last undone edit (no-op with nothing to redo). */
-    redo(): StudioSessionState;
-    /** Whether {@link undo}/{@link redo} would do anything from here. Mirror the
-     *  reactive {@link StudioSessionState.canUndo}/`canRedo` for imperative callers. */
-    canUndo(): boolean;
-    canRedo(): boolean;
-    /** Replace the whole document (a load, an import, an AI proposal). Clears the
-     *  undo history — you cannot undo across a document swap into the old one. */
-    reset(design: StudioDesign): StudioSessionState;
-    /** Resolves with the verification of the design current at that moment —
-     *  awaiting it after an `apply` is how a test or a save button gets a settled
-     *  answer without polling. */
-    settled(): Promise<StudioVerification>;
-    /** The save gate for the current state. `allowed: false` while unverified. */
-    disposition(): SaveDisposition;
-    /** Stop scheduling work; in-flight results are discarded. */
-    dispose(): void;
-}
-export declare function createStudioSession(options: StudioSessionOptions): StudioSession;
-//# sourceMappingURL=session.d.ts.map

package/dist/studio/session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/studio/session.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,0EAA0E;IAC1E,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,YAAY,CAAC;AAEhE,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,MAAM,EAAE,YAAY,CAAC;IACrB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,kBAAkB,CAAC;IAC/B,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE;;;+DAG2D;IAC3D,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB,CAAC;IACjE;qEACiE;IACjE,IAAI,IAAI,kBAAkB,CAAC;IAC3B,iEAAiE;IACjE,IAAI,IAAI,kBAAkB,CAAC;IAC3B;wFACoF;IACpF,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC;IACnB;kFAC8E;IAC9E,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAChD;;kCAE8B;IAC9B,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvC,8EAA8E;IAC9E,WAAW,IAAI,eAAe,CAAC;IAC/B,6DAA6D;IAC7D,OAAO,IAAI,IAAI,CAAC;CACjB;AAiBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAuJhF"}