@dreamboard-games/sdk 0.5.0-alpha.2 → 0.5.0-alpha.3

package/dist/testing-runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/testing/scenario-projection-digest.ts","../src/testing-runtime.ts"],"sourcesContent":["import { digestScenarioJson } from \"./canonical.js\";\nimport { interactionDomainEligibleCount } from \"../reducer/bundle/trusted/interaction-domain-metadata.js\";\nimport type { InspectNode, Sha256Digest } from \"./inspection/types.js\";\n\nexport type ScenarioProjectionInteractionInput = {\n  readonly key: string;\n  readonly kind: string;\n  readonly domain: unknown;\n};\n\n/** Shared SDK normalization for inspect DTOs and backend parity projections. */\nexport function scenarioProjectionInputMetadata(\n  input: ScenarioProjectionInteractionInput,\n): {\n  readonly key: string;\n  readonly kind: string;\n  readonly eligibleCount: number | \"lazy\";\n} {\n  return {\n    key: input.key,\n    kind: input.kind,\n    eligibleCount: interactionDomainEligibleCount(input.domain),\n  };\n}\n\nexport type ScenarioProjectionParity = {\n  readonly perspective: \"spectator\" | { readonly seat: number };\n  readonly flow: {\n    readonly phase: string;\n    readonly step: string | null;\n    readonly activeSeats: readonly number[];\n    readonly pendingSeats: readonly number[];\n    readonly continuationWaiterSeats: readonly number[];\n    readonly blockedBy: readonly {\n      readonly actorSeat: number;\n      readonly blockerSeats: readonly number[];\n    }[];\n  };\n  readonly view: unknown;\n  readonly interactions: readonly {\n    readonly actorSeat: number;\n    readonly interactionId: string;\n    readonly availability: {\n      readonly status: string;\n      readonly code?: string;\n      readonly reason?: string;\n    };\n    readonly inputs: readonly {\n      readonly key: string;\n      readonly kind: string;\n      readonly eligibleCount: number | \"lazy\";\n    }[];\n  }[];\n};\n\n/**\n * Canonical local/backend parity authority. It deliberately excludes raw\n * reducer public/private state, interaction explanations, entropy, and trace:\n * backend gameplay frames expose the selected projection, not reducer state.\n */\nexport function scenarioProjectionParityFromInspectNode(\n  node: InspectNode,\n): ScenarioProjectionParity {\n  return {\n    perspective:\n      node.perspective.kind === \"spectator\"\n        ? \"spectator\"\n        : { seat: node.perspective.actor.seat },\n    flow: {\n      phase: node.flow.phase,\n      step: node.flow.step,\n      activeSeats: node.flow.activeActors.map(({ seat }) => seat),\n      pendingSeats: node.flow.pendingActors.map(({ seat }) => seat),\n      continuationWaiterSeats: node.flow.continuationWaiters.map(\n        ({ seat }) => seat,\n      ),\n      blockedBy: node.flow.blockedBy.map(({ actor, blockers }) => ({\n        actorSeat: actor.seat,\n        blockerSeats: blockers.map(({ seat }) => seat),\n      })),\n    },\n    view: node.view,\n    interactions: node.interactions.map(\n      ({ actor, interactionId, availability, inputs }) => ({\n        actorSeat: actor.seat,\n        interactionId,\n        availability,\n        inputs,\n      }),\n    ),\n  };\n}\n\nexport function digestScenarioProjection(\n  projection: ScenarioProjectionParity,\n): Sha256Digest {\n  return digestScenarioJson({\n    digestVersion: \"scenario-projection@1\",\n    projection,\n  });\n}\n","import type { DispatchTraceSummaryEntry } from \"./reducer/diagnostics.js\";\nimport {\n  ScenarioReplayError,\n  type ScenarioDefinition,\n} from \"./testing/definitions.js\";\nimport type { ScenarioDefinitionGameLike } from \"./testing/scenario-definition-validation.js\";\nimport { assertScenario, replayScenario } from \"./testing/scenario-replay.js\";\n\nexport {\n  materializeScenarioRuntimeCheckpoint,\n  type ScenarioRuntimeCheckpointMaterialization,\n} from \"./testing/scenario-replay.js\";\n\n// Internal published seam for CLI scenario loading and backend parity. These\n// helpers intentionally do not appear on the author-facing `/testing` facade.\nexport { resolveScenarioCommandParams } from \"./testing/scenario-player-refs.js\";\nexport {\n  digestScenarioProjection,\n  scenarioProjectionInputMetadata,\n  scenarioProjectionParityFromInspectNode,\n  type ScenarioProjectionInteractionInput,\n  type ScenarioProjectionParity,\n} from \"./testing/scenario-projection-digest.js\";\n\nexport type CandidateVerificationScenario<\n  Game extends ScenarioDefinitionGameLike,\n> = ScenarioDefinition<Game>;\n\nexport type CandidateVerificationInput<\n  Game extends ScenarioDefinitionGameLike,\n> = {\n  /** The authored reducer game definition used by production dispatch. */\n  readonly reducer: Game;\n  readonly scenarios:\n    | Readonly<Record<string, CandidateVerificationScenario<Game>>>\n    | readonly CandidateVerificationScenario<Game>[];\n  readonly maxScenarios?: number;\n  readonly maxStepsPerScenario?: number;\n};\n\nexport type CandidateVerificationReplayDiagnostic = {\n  readonly kind: \"replay\";\n  readonly message: string;\n  readonly scenarioId?: string;\n  readonly segment?: \"given\" | \"when\";\n  readonly index?: number;\n  readonly interactionId?: string;\n  readonly errorCode?: string;\n  readonly reducerMessage?: string;\n  readonly trace?: readonly DispatchTraceSummaryEntry[];\n};\n\nexport type CandidateVerificationAssertionDiagnostic = {\n  readonly kind: \"assertion\";\n  readonly message: string;\n};\n\nexport type CandidateVerificationLimitDiagnostic = {\n  readonly kind: \"limit\";\n  readonly message: string;\n  readonly actualSteps: number;\n  readonly maxStepsPerScenario: number;\n};\n\nexport type CandidateVerificationScenarioResult = {\n  readonly id: string;\n  readonly status: \"passed\" | \"failed\";\n  readonly diagnostic?:\n    | CandidateVerificationReplayDiagnostic\n    | CandidateVerificationAssertionDiagnostic\n    | CandidateVerificationLimitDiagnostic;\n};\n\nexport type CandidateVerificationResult = {\n  readonly status: \"passed\" | \"failed\";\n  readonly scenarioSummary: {\n    readonly total: number;\n    readonly passed: number;\n    readonly failed: number;\n    readonly scenarios: readonly CandidateVerificationScenarioResult[];\n  };\n};\n\nconst CANDIDATE_INPUT_FIELDS = new Set([\n  \"reducer\",\n  \"scenarios\",\n  \"maxScenarios\",\n  \"maxStepsPerScenario\",\n]);\nconst MAX_DIAGNOSTIC_MESSAGE_LENGTH = 2_000;\nconst MAX_DIAGNOSTIC_TRACE_ENTRIES = 100;\n\nexport async function runCandidateVerification<\n  const Game extends ScenarioDefinitionGameLike,\n>(\n  input: CandidateVerificationInput<Game>,\n): Promise<CandidateVerificationResult> {\n  assertCandidateInputFields(input);\n  const scenarios = normalizeScenarios(input.scenarios);\n  if (scenarios.length === 0) {\n    throw new Error(\"Candidate verification requires at least one scenario.\");\n  }\n\n  const maxScenarios = input.maxScenarios ?? scenarios.length;\n  assertPositiveInteger(maxScenarios, \"maxScenarios\");\n  if (scenarios.length > maxScenarios) {\n    throw new Error(\n      `Candidate verification contains ${scenarios.length} scenarios, exceeding limit ${maxScenarios}.`,\n    );\n  }\n\n  const maxStepsPerScenario = input.maxStepsPerScenario ?? 1_000;\n  assertPositiveInteger(maxStepsPerScenario, \"maxStepsPerScenario\");\n\n  const results: CandidateVerificationScenarioResult[] = [];\n  for (const scenario of scenarios) {\n    results.push(\n      await runScenario({\n        reducer: input.reducer,\n        scenario,\n        maxStepsPerScenario,\n      }),\n    );\n  }\n\n  const failed = results.filter((result) => result.status === \"failed\").length;\n  return {\n    status: failed === 0 ? \"passed\" : \"failed\",\n    scenarioSummary: {\n      total: results.length,\n      passed: results.length - failed,\n      failed,\n      scenarios: results,\n    },\n  };\n}\n\nasync function runScenario<Game extends ScenarioDefinitionGameLike>(input: {\n  readonly reducer: Game;\n  readonly scenario: CandidateVerificationScenario<Game>;\n  readonly maxStepsPerScenario: number;\n}): Promise<CandidateVerificationScenarioResult> {\n  const actualSteps = input.scenario.given.length + input.scenario.when.length;\n  if (actualSteps > input.maxStepsPerScenario) {\n    return {\n      id: input.scenario.id,\n      status: \"failed\",\n      diagnostic: {\n        kind: \"limit\",\n        message:\n          `Scenario contains ${actualSteps} replay steps, exceeding ` +\n          `maxStepsPerScenario limit ${input.maxStepsPerScenario}.`,\n        actualSteps,\n        maxStepsPerScenario: input.maxStepsPerScenario,\n      },\n    };\n  }\n\n  let replay;\n  try {\n    replay = await replayScenario({\n      game: input.reducer,\n      scenario: input.scenario,\n    });\n  } catch (error) {\n    return {\n      id: input.scenario.id,\n      status: \"failed\",\n      diagnostic: replayDiagnostic(error),\n    };\n  }\n\n  try {\n    await assertScenario({ replay, assertion: input.scenario.then });\n    return { id: input.scenario.id, status: \"passed\" };\n  } catch (error) {\n    return {\n      id: input.scenario.id,\n      status: \"failed\",\n      diagnostic: {\n        kind: \"assertion\",\n        message: boundedMessage(error),\n      },\n    };\n  }\n}\n\nfunction assertCandidateInputFields(input: object): void {\n  for (const field of Object.keys(input)) {\n    if (!CANDIDATE_INPUT_FIELDS.has(field)) {\n      throw new Error(\n        `Candidate verification input contains unsupported field '${field}'.`,\n      );\n    }\n  }\n}\n\nfunction assertPositiveInteger(value: number, field: string): void {\n  if (!Number.isSafeInteger(value) || value < 1) {\n    throw new Error(`${field} must be a positive safe integer.`);\n  }\n}\n\nfunction normalizeScenarios<Game extends ScenarioDefinitionGameLike>(\n  input:\n    | Readonly<Record<string, CandidateVerificationScenario<Game>>>\n    | readonly CandidateVerificationScenario<Game>[],\n): CandidateVerificationScenario<Game>[] {\n  if (typeof input !== \"object\" || input === null) {\n    throw new Error(\n      \"Candidate verification scenarios must be an array or record.\",\n    );\n  }\n  const scenarios = Array.isArray(input) ? [...input] : Object.values(input);\n  const seenIds = new Set<string>();\n  for (const scenario of scenarios) {\n    if (typeof scenario?.id !== \"string\" || scenario.id.length === 0) {\n      throw new Error(\"Candidate verification scenario id is required.\");\n    }\n    if (seenIds.has(scenario.id)) {\n      throw new Error(\n        `Candidate verification scenario id '${scenario.id}' is duplicated.`,\n      );\n    }\n    seenIds.add(scenario.id);\n  }\n  return scenarios;\n}\n\nfunction replayDiagnostic(\n  error: unknown,\n): CandidateVerificationReplayDiagnostic {\n  if (error instanceof ScenarioReplayError) {\n    return {\n      kind: \"replay\",\n      message: boundedMessage(error),\n      scenarioId: error.scenarioId,\n      segment: error.segment,\n      index: error.index,\n      interactionId: error.interactionId,\n      errorCode: error.errorCode,\n      ...(error.reducerMessage === undefined\n        ? {}\n        : { reducerMessage: boundedText(error.reducerMessage) }),\n      trace: error.trace.slice(0, MAX_DIAGNOSTIC_TRACE_ENTRIES),\n    };\n  }\n  return { kind: \"replay\", message: boundedMessage(error) };\n}\n\nfunction boundedMessage(error: unknown): string {\n  return boundedText(error instanceof Error ? error.message : String(error));\n}\n\nfunction boundedText(value: string): string {\n  return value.slice(0, MAX_DIAGNOSTIC_MESSAGE_LENGTH);\n}\n"],"mappings":"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","names":[]}

package/dist/types-DJj5MJkl.d.ts

@@ -1,256 +0,0 @@
-declare const DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_NAME: "dreamboard-browser-interaction";
-declare const DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION: "3.0.0";
-declare const BROWSER_INTERACTION_ATTRIBUTES: {
-    readonly protocol: "data-dreamboard-browser-protocol";
-    readonly surface: "data-dreamboard-browser-surface";
-    readonly scope: "data-dreamboard-browser-scope";
-    readonly role: "data-dreamboard-browser-role";
-    readonly intent: "data-dreamboard-browser-intent";
-    readonly interactionKey: "data-dreamboard-interaction-key";
-    readonly interactionId: "data-dreamboard-interaction-id";
-    readonly descriptorDigest: "data-dreamboard-descriptor-digest";
-    readonly draftDigest: "data-dreamboard-draft-digest";
-    readonly readiness: "data-dreamboard-readiness";
-    readonly inputKey: "data-dreamboard-input-key";
-    readonly candidateValue: "data-dreamboard-candidate-value";
-    readonly candidateState: "data-dreamboard-candidate-state";
-    readonly actuatorKind: "data-dreamboard-actuator-kind";
-    readonly enabled: "data-dreamboard-actuator-enabled";
-    readonly actuatorId: "data-dreamboard-actuator-id";
-    readonly pointerTargetId: "data-dreamboard-pointer-target-id";
-    readonly pointerTargetEnabled: "data-dreamboard-pointer-target-enabled";
-    readonly semanticEffects: "data-dreamboard-semantic-effects";
-    readonly acceptedEffectPatterns: "data-dreamboard-accepted-effect-patterns";
-    readonly preparationPatterns: "data-dreamboard-preparation-patterns";
-    readonly preparesIntent: "data-dreamboard-prepares-intent";
-    readonly preparesInputKey: "data-dreamboard-prepares-input-key";
-    readonly preparesCandidateValue: "data-dreamboard-prepares-candidate-value";
-    readonly preparesActuatorKind: "data-dreamboard-prepares-actuator-kind";
-    readonly diagnostic: "data-dreamboard-browser-diagnostic";
-};
-declare const BROWSER_INTERACTION_RECORD_ROLES: readonly ["interaction", "actuator", "pointer-target"];
-declare const GAMEPLAY_BROWSER_INTERACTION_SURFACE: "gameplay";
-declare const GAMEPLAY_BROWSER_INTERACTION_INTENTS: readonly ["arm", "reveal", "invoke", "select", "toggle", "increment", "decrement", "fill", "submit"];
-declare const GAMEPLAY_BROWSER_INTERACTION_EFFECT_KINDS: readonly ["setCandidate", "adjustResource", "setScalar", "commit", "invoke"];
-declare const BROWSER_INTERACTION_READINESS_VALUES: readonly ["ready", "blocked", "unavailable"];
-declare const BROWSER_INTERACTION_CANDIDATE_STATES: readonly ["selected", "unselected", "mixed"];
-declare const BROWSER_INTERACTION_ACTUATOR_KINDS: readonly ["click", "fill", "keyboard", "pointer"];
-
-type CanonicalBrowserInteractionValue = null | boolean | number | string | readonly CanonicalBrowserInteractionValue[] | {
-    readonly [key: string]: CanonicalBrowserInteractionValue;
-};
-declare function encodeCanonicalCandidateValue(value: unknown): string;
-declare function decodeCanonicalCandidateValue(encoded: string): CanonicalBrowserInteractionValue;
-declare function compareStableJson(a: unknown, b: unknown): number;
-
-type BrowserInteractionSurface = string;
-type BrowserInteractionIntent = string;
-type GameplayBrowserInteractionSurface = typeof GAMEPLAY_BROWSER_INTERACTION_SURFACE;
-type GameplayBrowserInteractionIntent = (typeof GAMEPLAY_BROWSER_INTERACTION_INTENTS)[number];
-type GameplayBrowserInteractionEffectKind = (typeof GAMEPLAY_BROWSER_INTERACTION_EFFECT_KINDS)[number];
-type BrowserInteractionReadiness = (typeof BROWSER_INTERACTION_READINESS_VALUES)[number];
-type BrowserInteractionCandidateState = (typeof BROWSER_INTERACTION_CANDIDATE_STATES)[number];
-type BrowserInteractionActuatorKind = (typeof BROWSER_INTERACTION_ACTUATOR_KINDS)[number];
-interface BrowserInteractionProtocolIdentity {
-    readonly name: "dreamboard-browser-interaction";
-    readonly version: "3.0.0";
-}
-type BrowserInteractionSurfaceEffect = {
-    readonly kind: string;
-    readonly [key: string]: CanonicalBrowserInteractionValue;
-};
-interface BrowserInteractionScalarPattern {
-    readonly field: string;
-    readonly min?: number;
-    readonly max?: number;
-    readonly integer?: boolean;
-}
-type BrowserInteractionEffectPattern<Effect extends BrowserInteractionSurfaceEffect = BrowserInteractionSurfaceEffect> = {
-    readonly kind: "exact";
-    readonly effect: Effect;
-} | {
-    readonly kind: "match";
-    readonly effectKind: Effect["kind"] & string;
-    readonly fields?: Readonly<Record<string, CanonicalBrowserInteractionValue>>;
-    readonly scalar?: BrowserInteractionScalarPattern;
-};
-type GameplaySemanticEffect = {
-    readonly kind: "setCandidate";
-    readonly inputKey: string;
-    readonly candidateValue: CanonicalBrowserInteractionValue;
-    readonly beforeSelected: boolean;
-    readonly afterSelected: boolean;
-} | {
-    readonly kind: "adjustResource";
-    readonly inputKey: string;
-    readonly resourceKey: CanonicalBrowserInteractionValue;
-    readonly delta: -1 | 1;
-} | {
-    readonly kind: "setScalar";
-    readonly inputKey: string;
-    readonly value: number;
-} | {
-    readonly kind: "commit";
-} | {
-    readonly kind: "invoke";
-};
-type GameplaySemanticEffectPattern = BrowserInteractionEffectPattern<GameplaySemanticEffect>;
-interface BrowserInteractionDiagnostic {
-    readonly code: "ambiguous-actuator" | "ambiguous-effect-match" | "ambiguous-pointer-target" | "ambiguous-preparation-pattern" | "disabled-effect-actuator" | "disabled-pointer-target" | "duplicate-accepted-effect-pattern-match" | "duplicate-enabled-actuator" | "duplicate-enabled-effect-actuator" | "duplicate-enabled-pointer-target" | "effect-actuator-kind-incompatibility" | "effect-intent-incompatibility" | "invalid-candidate" | "invalid-effect-payload" | "invalid-effect-pattern" | "invalid-protocol" | "invalid-record" | "invalid-scalar-argument" | "missing-effect" | "orphan-actuator" | "orphan-pointer-target" | "preparation-cycle" | "surface-intent-collision" | "unknown-surface-effect" | "unknown-intent" | "unknown-surface" | "unavailable-actuator";
-    readonly severity: "error" | "warning";
-    readonly message: string;
-    readonly surface?: BrowserInteractionSurface;
-    readonly scopeId?: string;
-    readonly interactionKey?: string;
-    readonly intent?: BrowserInteractionIntent;
-    readonly actuatorId?: string;
-    readonly targetId?: string;
-}
-interface BrowserInteractionRawRecord {
-    readonly attributes: Readonly<Record<string, string | boolean | null | undefined>>;
-}
-interface BrowserInteractionPreparationTarget {
-    readonly intent: BrowserInteractionIntent;
-    readonly inputKey?: string;
-    readonly candidateValue?: CanonicalBrowserInteractionValue;
-    readonly candidateValueKey?: string;
-    readonly actuatorKind?: BrowserInteractionActuatorKind;
-}
-interface BrowserInteractionActuator {
-    readonly actuatorId: string;
-    readonly intent: BrowserInteractionIntent;
-    readonly descriptorDigest?: string;
-    readonly draftDigest?: string;
-    readonly inputKey?: string;
-    readonly candidateValue?: CanonicalBrowserInteractionValue;
-    readonly candidateValueKey?: string;
-    readonly candidateState?: BrowserInteractionCandidateState;
-    readonly enabled: boolean;
-    readonly actuatorKind: BrowserInteractionActuatorKind;
-    readonly semanticEffects: readonly BrowserInteractionSurfaceEffect[];
-    readonly acceptedEffectPatterns: readonly BrowserInteractionEffectPattern[];
-    readonly preparationPatterns: readonly BrowserInteractionEffectPattern[];
-    readonly prepares?: BrowserInteractionPreparationTarget;
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionPointerTarget {
-    readonly targetId: string;
-    readonly enabled: boolean;
-    readonly acceptedEffectPatterns: readonly BrowserInteractionEffectPattern[];
-    readonly descriptorDigest?: string;
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionEntity {
-    readonly interactionKey: string;
-    readonly interactionId: string;
-    readonly descriptorDigest?: string;
-    readonly draftDigest?: string;
-    readonly readiness: BrowserInteractionReadiness;
-    readonly actuators: readonly BrowserInteractionActuator[];
-    readonly pointerTargets: readonly BrowserInteractionPointerTarget[];
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-type BrowserGameplayInteraction = BrowserInteractionEntity;
-interface BrowserInteractionSemanticSurfaceSnapshot<Surface extends BrowserInteractionSurface = BrowserInteractionSurface> {
-    readonly surface: Surface;
-    readonly scopeId: string;
-    readonly interactions: readonly BrowserInteractionEntity[];
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserGameplaySurfaceSnapshot {
-    readonly surface: GameplayBrowserInteractionSurface;
-    readonly scopeId: string;
-    readonly interactions: readonly BrowserGameplayInteraction[];
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionUnknownSurfaceSnapshot {
-    readonly surface: BrowserInteractionSurface;
-    readonly scopeId: string;
-    readonly interactions?: never;
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-type BrowserInteractionSurfaceSnapshot = BrowserGameplaySurfaceSnapshot | BrowserInteractionSemanticSurfaceSnapshot | BrowserInteractionUnknownSurfaceSnapshot;
-interface BrowserInteractionSnapshot {
-    readonly protocol: BrowserInteractionProtocolIdentity;
-    readonly surfaces: readonly BrowserInteractionSurfaceSnapshot[];
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionSurfaceDefinition<Surface extends BrowserInteractionSurface = BrowserInteractionSurface, Intent extends BrowserInteractionIntent = BrowserInteractionIntent, EffectKind extends string = string> {
-    readonly surface: Surface;
-    readonly intents: readonly Intent[];
-    readonly effectKinds?: readonly EffectKind[];
-}
-interface BrowserInteractionRegistry {
-    readonly surfaces: ReadonlyMap<BrowserInteractionSurface, BrowserInteractionSurfaceDefinition>;
-}
-interface BrowserInteractionIntentRequest {
-    readonly surface: BrowserInteractionSurface;
-    readonly scopeId?: string;
-    readonly interactionKey?: string;
-    readonly interactionId?: string;
-    readonly intent: BrowserInteractionIntent;
-    readonly inputKey?: string;
-    readonly candidateValue?: unknown;
-    readonly candidateValueKey?: string;
-    readonly actuatorKind?: BrowserInteractionActuatorKind;
-    readonly allowDisabled?: boolean;
-}
-interface BrowserInteractionEffectRequest<Effect extends BrowserInteractionSurfaceEffect = BrowserInteractionSurfaceEffect> {
-    readonly surface: BrowserInteractionSurface;
-    readonly scopeId?: string;
-    readonly interactionKey?: string;
-    readonly interactionId?: string;
-    readonly effect: Effect;
-    readonly allowDisabled?: boolean;
-}
-type GameplayBrowserInteractionEffectRequest = BrowserInteractionEffectRequest<GameplaySemanticEffect>;
-interface BrowserInteractionResolutionSuccess {
-    readonly ok: true;
-    readonly actuator: BrowserInteractionActuator;
-    readonly surface: BrowserInteractionSurface;
-    readonly scopeId: string;
-    readonly interactionKey: string;
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionResolutionFailure {
-    readonly ok: false;
-    readonly code: "ambiguous" | "invalid-snapshot" | "not-found" | "preparation-required" | "unavailable";
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-    readonly preparation?: readonly BrowserInteractionActuator[];
-}
-type BrowserInteractionResolution = BrowserInteractionResolutionSuccess | BrowserInteractionResolutionFailure;
-interface BrowserInteractionEffectResolutionSuccess {
-    readonly ok: true;
-    readonly actuator: BrowserInteractionActuator;
-    readonly surface: BrowserInteractionSurface;
-    readonly scopeId: string;
-    readonly interactionKey: string;
-    readonly match: "exact" | "accepted-pattern";
-    readonly effect: BrowserInteractionSurfaceEffect;
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionPointerTargetResolutionSuccess {
-    readonly ok: true;
-    readonly pointerTarget: BrowserInteractionPointerTarget;
-    readonly surface: BrowserInteractionSurface;
-    readonly scopeId: string;
-    readonly interactionKey: string;
-    readonly match: "accepted-pattern";
-    readonly effect: BrowserInteractionSurfaceEffect;
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-interface BrowserInteractionPointerTargetResolutionFailure {
-    readonly ok: false;
-    readonly code: "ambiguous" | "invalid-effect" | "invalid-snapshot" | "not-found" | "unavailable";
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-}
-type BrowserInteractionPointerTargetResolution = BrowserInteractionPointerTargetResolutionSuccess | BrowserInteractionPointerTargetResolutionFailure;
-interface BrowserInteractionEffectResolutionFailure {
-    readonly ok: false;
-    readonly code: "ambiguous" | "invalid-effect" | "invalid-snapshot" | "not-found" | "preparation-required" | "unavailable";
-    readonly diagnostics: readonly BrowserInteractionDiagnostic[];
-    readonly preparation?: readonly BrowserInteractionActuator[];
-}
-type BrowserInteractionEffectResolution = BrowserInteractionEffectResolutionSuccess | BrowserInteractionEffectResolutionFailure;
-
-export { encodeCanonicalCandidateValue as $, type BrowserInteractionRegistry as A, BROWSER_INTERACTION_ACTUATOR_KINDS as B, type BrowserInteractionResolution as C, type BrowserInteractionResolutionFailure as D, type BrowserInteractionResolutionSuccess as E, type BrowserInteractionScalarPattern as F, type BrowserInteractionSemanticSurfaceSnapshot as G, type BrowserInteractionSnapshot as H, type BrowserInteractionSurface as I, type BrowserInteractionSurfaceDefinition as J, type BrowserInteractionSurfaceEffect as K, type BrowserInteractionSurfaceSnapshot as L, type BrowserInteractionUnknownSurfaceSnapshot as M, type CanonicalBrowserInteractionValue as N, DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_NAME as O, DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION as P, GAMEPLAY_BROWSER_INTERACTION_EFFECT_KINDS as Q, GAMEPLAY_BROWSER_INTERACTION_INTENTS as R, GAMEPLAY_BROWSER_INTERACTION_SURFACE as S, type GameplayBrowserInteractionEffectKind as T, type GameplayBrowserInteractionEffectRequest as U, type GameplayBrowserInteractionIntent as V, type GameplayBrowserInteractionSurface as W, type GameplaySemanticEffect as X, type GameplaySemanticEffectPattern as Y, compareStableJson as Z, decodeCanonicalCandidateValue as _, BROWSER_INTERACTION_ATTRIBUTES as a, BROWSER_INTERACTION_CANDIDATE_STATES as b, BROWSER_INTERACTION_READINESS_VALUES as c, BROWSER_INTERACTION_RECORD_ROLES as d, type BrowserGameplayInteraction as e, type BrowserGameplaySurfaceSnapshot as f, type BrowserInteractionActuator as g, type BrowserInteractionActuatorKind as h, type BrowserInteractionCandidateState as i, type BrowserInteractionDiagnostic as j, type BrowserInteractionEffectPattern as k, type BrowserInteractionEffectRequest as l, type BrowserInteractionEffectResolution as m, type BrowserInteractionEffectResolutionFailure as n, type BrowserInteractionEffectResolutionSuccess as o, type BrowserInteractionEntity as p, type BrowserInteractionIntent as q, type BrowserInteractionIntentRequest as r, type BrowserInteractionPointerTarget as s, type BrowserInteractionPointerTargetResolution as t, type BrowserInteractionPointerTargetResolutionFailure as u, type BrowserInteractionPointerTargetResolutionSuccess as v, type BrowserInteractionPreparationTarget as w, type BrowserInteractionProtocolIdentity as x, type BrowserInteractionRawRecord as y, type BrowserInteractionReadiness as z };

package/dist/types-DR7DoB1x.d.ts

@@ -1,28 +0,0 @@
-import { E, v, H, J } from './protocol-dYgafTYY.js';
-
-interface RuntimeClock {
-    now(): number;
-}
-interface RuntimeIdFactory {
-    nextId(prefix: string): string;
-}
-interface PluginTransport {
-    start(onMessage: (message: H) => void): () => void;
-    send(message: J): void;
-}
-interface PluginRuntimeClient {
-    getSession(): E | null;
-    subscribeSession(listener: () => void): () => void;
-    getFrame(): v | null;
-    subscribeFrame(listener: () => void): () => void;
-    submitInteraction(interactionId: string, params: unknown): Promise<void>;
-    disconnect(): void;
-}
-interface PluginRuntimeClientOptions {
-    transport: PluginTransport;
-    idFactory?: RuntimeIdFactory;
-    clock?: RuntimeClock;
-    requestTimeoutMs?: number;
-}
-
-export type { PluginRuntimeClient as P, RuntimeClock as R, PluginRuntimeClientOptions as a, PluginTransport as b, RuntimeIdFactory as c };

package/dist/types-JWCYHmu7.d.ts

@@ -1,122 +0,0 @@
-import { w as wire } from './index.d-DjzoK7zn.js';
-import { h as ScenarioCheckpoint, o as ScenarioDefinitionGameLike, d as ReplayScenarioOptions, A as AssertScenarioOptions, w as ScenarioReplay, l as ScenarioCommandOf, v as ScenarioProbeResult, F as ScenarioSetup, c as InteractionExplanationLike } from './definitions-BgmV_GhC.js';
-
-declare function replayScenario<const Game extends ScenarioDefinitionGameLike>(options: ReplayScenarioOptions<Game>): Promise<ScenarioReplay<Game>>;
-type ScenarioRuntimeCheckpointMaterialization = {
-    readonly checkpoint: ScenarioCheckpoint;
-    readonly checkpointDigest: string;
-    readonly playerIds: readonly string[];
-    readonly state: wire.ReducerSessionState;
-};
-/**
- * Trusted tool-side materialization for CLI, Workbench, and backend adapters.
- * The returned reducer snapshot must never cross a player/browser boundary.
- */
-declare function materializeScenarioRuntimeCheckpoint<const Game extends ScenarioDefinitionGameLike>(options: ReplayScenarioOptions<Game>): Promise<ScenarioRuntimeCheckpointMaterialization>;
-declare function assertScenario<Game>(options: AssertScenarioOptions<Game>): Promise<void>;
-declare function probeScenarioCommand<Game>(options: {
-    readonly replay: ScenarioReplay<Game>;
-    readonly command: ScenarioCommandOf<Game>;
-}): Promise<ScenarioProbeResult<Game>>;
-
-type Sha256Digest = `sha256:${string}`;
-type ScenarioIdentity = {
-    readonly id: string;
-    readonly path: string;
-    readonly sourceDigest: Sha256Digest;
-};
-type ActorRef = {
-    readonly seat: number;
-    readonly playerId: string;
-};
-type PerspectiveRef = {
-    readonly kind: "player";
-    readonly actor: ActorRef;
-} | {
-    readonly kind: "spectator";
-};
-type PerspectiveSelector = {
-    readonly kind: "player";
-    readonly seat: number;
-} | {
-    readonly kind: "spectator";
-};
-type FlowDiagnostic = {
-    readonly phase: string;
-    readonly step: string | null;
-    readonly activeActors: readonly ActorRef[];
-    readonly pendingActors: readonly ActorRef[];
-    readonly continuationWaiters: readonly ActorRef[];
-    readonly blockedBy: readonly {
-        readonly actor: ActorRef;
-        readonly blockers: readonly ActorRef[];
-        readonly source: "scheduler";
-    }[];
-};
-type InspectInteractionInput = {
-    readonly key: string;
-    readonly kind: string;
-    readonly eligibleCount: number | "lazy";
-};
-type InspectInteraction = {
-    readonly actor: ActorRef;
-    readonly interactionId: string;
-    readonly availability: {
-        readonly status: "available" | "notYourTurn" | "insufficientResources" | "blocked";
-        readonly code?: string;
-        readonly reason?: string;
-    };
-    readonly inputs: readonly InspectInteractionInput[];
-    readonly explanation: InteractionExplanationLike;
-};
-type InspectAction = {
-    readonly actor: ActorRef;
-    readonly interactionId: string;
-    readonly inputs: readonly InspectInteractionInput[];
-    readonly explanation: InteractionExplanationLike;
-    readonly hasConcreteCommand: true;
-};
-type ScenarioDispatchTraceEntry = {
-    readonly kind: "acceptedCommand";
-    readonly actor: ActorRef;
-    readonly interactionId: string;
-} | {
-    readonly kind: "appliedInstruction";
-    readonly instructionKind: string;
-} | {
-    readonly kind: "entropyDraw";
-    readonly drawIndex: number;
-};
-type InspectEntropy = {
-    readonly seed: number;
-    readonly draws: readonly {
-        readonly index: number;
-        readonly cursorBefore: number;
-        readonly cursorAfter: number;
-        readonly operation: {
-            readonly kind: string;
-            readonly parameters: Readonly<Record<string, string | number | boolean>>;
-        };
-    }[];
-};
-type InspectNode = {
-    readonly checkpoint: ScenarioCheckpoint;
-    readonly checkpointDigest: Sha256Digest;
-    readonly setup: ScenarioSetup;
-    readonly flow: FlowDiagnostic;
-    readonly perspective: PerspectiveRef;
-    readonly publicState: unknown;
-    readonly view: unknown;
-    readonly interactions: readonly InspectInteraction[];
-    readonly actions: readonly InspectAction[];
-    readonly entropy: InspectEntropy;
-    readonly dispatchTrace: readonly ScenarioDispatchTraceEntry[];
-};
-type InspectScenarioResult = {
-    readonly schemaVersion: 1;
-    readonly scenario: ScenarioIdentity;
-    readonly node: InspectNode;
-    readonly seedSource: "scenario" | "override";
-};
-
-export { type ActorRef as A, type FlowDiagnostic as F, type InspectAction as I, type PerspectiveRef as P, type ScenarioDispatchTraceEntry as S, type InspectEntropy as a, type InspectInteraction as b, type InspectInteractionInput as c, type InspectNode as d, type InspectScenarioResult as e, type PerspectiveSelector as f, type ScenarioIdentity as g, type ScenarioRuntimeCheckpointMaterialization as h, type Sha256Digest as i, assertScenario as j, materializeScenarioRuntimeCheckpoint as m, probeScenarioCommand as p, replayScenario as r };