@almadar/ui 6.59.0 → 6.61.0

package/dist/{chunk-KJGVLXEN.js → chunk-N4IJS5DD.js}

@@ -1,6 +1,5 @@
-import { domPassthrough, cn } from './chunk-64WACXM7.js';
-import { useState, useRef, useCallback, useLayoutEffect, useEffect, useSyncExternalStore } from 'react';
-import { jsx } from 'react/jsx-runtime';
+import { isMotionEnabled } from './chunk-N23SVGTH.js';
+import { useRef, useLayoutEffect, useSyncExternalStore } from 'react';
 import { ENTER_DELAY_STEPS, ENTER_ANIMATIONS, isFileValue } from '@almadar/core';
 export { getNestedValue } from '@almadar/core';
 import { perfStore, pushPerfEntry } from '@almadar/runtime/ui';
@@ -87,71 +86,6 @@ function eightPointedStarPath(cx, cy, outerR, innerR) {
 function arrowheadPath(size) {
   return `M 0 0 L ${size} ${size / 2} L 0 ${size} Z`;
 }
-var SAFE_EXIT_MS = 1e3;
-var motionEnabledCache = null;
-function isMotionEnabled() {
-  if (typeof document === "undefined") return true;
-  if (motionEnabledCache !== null) return motionEnabledCache;
-  const v = getComputedStyle(document.documentElement).getPropertyValue("--motion-enable").trim().toLowerCase();
-  motionEnabledCache = v !== "off";
-  return motionEnabledCache;
-}
-function usePresence(show, opts) {
-  const { animation, animate = true, onExited } = opts;
-  const [mounted, setMounted] = useState(show);
-  const [exiting, setExiting] = useState(false);
-  const prev = useRef(show);
-  const onExitedRef = useRef(onExited);
-  onExitedRef.current = onExited;
-  const safeTimer = useRef(null);
-  const clearSafe = useCallback(() => {
-    if (safeTimer.current) {
-      clearTimeout(safeTimer.current);
-      safeTimer.current = null;
-    }
-  }, []);
-  const finishExit = useCallback(() => {
-    clearSafe();
-    setExiting(false);
-    setMounted(false);
-    onExitedRef.current?.();
-  }, [clearSafe]);
-  useLayoutEffect(() => {
-    const moving = animate && isMotionEnabled();
-    if (show && !prev.current) {
-      setExiting(false);
-      setMounted(true);
-    } else if (!show && prev.current) {
-      if (moving) {
-        setExiting(true);
-        clearSafe();
-        safeTimer.current = setTimeout(finishExit, SAFE_EXIT_MS);
-      } else {
-        setMounted(false);
-        setExiting(false);
-        onExitedRef.current?.();
-      }
-    }
-    prev.current = show;
-  }, [show, animate, clearSafe, finishExit]);
-  useEffect(() => () => clearSafe(), [clearSafe]);
-  const disabled = !animate || !isMotionEnabled();
-  const className = disabled ? "" : show ? `animate-${animation}-in` : `animate-${animation}-out`;
-  const onAnimationEnd = useCallback(
-    (e) => {
-      if (e.target !== e.currentTarget) return;
-      if (exiting) finishExit();
-    },
-    [exiting, finishExit]
-  );
-  return { mounted, exiting, className, onAnimationEnd };
-}
-var Presence = ({ show, className, children, ...rest }) => {
-  const { mounted, className: animClass, onAnimationEnd } = usePresence(show, rest);
-  if (!mounted) return null;
-  return /* @__PURE__ */ jsx("div", { className: cn(animClass, className), onAnimationEnd, ...domPassthrough(rest), children });
-};
-Presence.displayName = "Presence";
 var ENTER_SLOT_CLASS = "almadar-enter-slot";
 function asEnterAnimation(value) {
   return ENTER_ANIMATIONS.find((e) => e === value);
@@ -774,6 +708,53 @@ function parseContentSegments(content) {
   }
   return segments;
 }
+
+// lib/traitRegistry.ts
+var traits = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+function notifyListeners() {
+  listeners.forEach((listener) => listener());
+}
+function registerTrait(info) {
+  traits.set(info.id, info);
+  notifyListeners();
+}
+function updateTraitState(id, newState) {
+  const trait = traits.get(id);
+  if (trait) {
+    trait.currentState = newState;
+    trait.transitionCount++;
+    notifyListeners();
+  }
+}
+function updateGuardResult(traitId, guardName, result) {
+  const trait = traits.get(traitId);
+  if (trait) {
+    const guard = trait.guards.find((g) => g.name === guardName);
+    if (guard) {
+      guard.lastResult = result;
+      notifyListeners();
+    }
+  }
+}
+function unregisterTrait(id) {
+  traits.delete(id);
+  notifyListeners();
+}
+function getAllTraits() {
+  return Array.from(traits.values());
+}
+function getTrait(id) {
+  return traits.get(id);
+}
+function subscribeToTraitChanges(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+function clearTraits() {
+  traits.clear();
+  notifyListeners();
+}
 var NAMESPACE = "almadar:ui:debug";
 var log = createLogger(NAMESPACE);
 var inputLog = createLogger("almadar:ui:debug:input");
@@ -859,53 +840,6 @@ function toLogMetaValue(v) {
   return String(v);
 }
 
-// lib/traitRegistry.ts
-var traits = /* @__PURE__ */ new Map();
-var listeners = /* @__PURE__ */ new Set();
-function notifyListeners() {
-  listeners.forEach((listener) => listener());
-}
-function registerTrait(info) {
-  traits.set(info.id, info);
-  notifyListeners();
-}
-function updateTraitState(id, newState) {
-  const trait = traits.get(id);
-  if (trait) {
-    trait.currentState = newState;
-    trait.transitionCount++;
-    notifyListeners();
-  }
-}
-function updateGuardResult(traitId, guardName, result) {
-  const trait = traits.get(traitId);
-  if (trait) {
-    const guard = trait.guards.find((g) => g.name === guardName);
-    if (guard) {
-      guard.lastResult = result;
-      notifyListeners();
-    }
-  }
-}
-function unregisterTrait(id) {
-  traits.delete(id);
-  notifyListeners();
-}
-function getAllTraits() {
-  return Array.from(traits.values());
-}
-function getTrait(id) {
-  return traits.get(id);
-}
-function subscribeToTraitChanges(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-function clearTraits() {
-  traits.clear();
-  notifyListeners();
-}
-
 // lib/tickRegistry.ts
 var ticks = /* @__PURE__ */ new Map();
 var listeners2 = /* @__PURE__ */ new Set();
@@ -1195,4 +1129,4 @@ function parseLessonSegments(lesson) {
   return segments;
 }
 
-export { EDITOR_MOTIONS, EDITOR_OPERATORS, ENTER_SLOT_CLASS, INDENT_UNIT, MAX_ENTER_DELAY, Presence, applyMotion, applyOperator, arrowheadPath, asEnterAnimation, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, computeLineDiff, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, enterClassName, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, isDebugEnabled2, isEditorMotion, isEditorOperator, isMotionEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, motionRange, onDebugToggle, parseContentSegments, parseLessonSegments, parseMarkdownWithCodeBlocks, parseMarkdownWithCodeBlocks2, pipeIconPath, profilerOnRender, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, slotPlaysDefaultEnter, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState, usePerfBuffer, usePresence, useSlotEnterRestart };
+export { EDITOR_MOTIONS, EDITOR_OPERATORS, ENTER_SLOT_CLASS, INDENT_UNIT, MAX_ENTER_DELAY, applyMotion, applyOperator, arrowheadPath, asEnterAnimation, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, computeLineDiff, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, enterClassName, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, isDebugEnabled2, isEditorMotion, isEditorOperator, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, motionRange, onDebugToggle, parseContentSegments, parseLessonSegments, parseMarkdownWithCodeBlocks, parseMarkdownWithCodeBlocks2, pipeIconPath, profilerOnRender, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, slotPlaysDefaultEnter, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState, usePerfBuffer, useSlotEnterRestart };

package/dist/{chunk-I5QOYW2Z.js → chunk-UTSDPJUP.js}

@@ -1,5 +1,10 @@
+import { ar_default, sl_default } from './chunk-CB64IOYD.js';
 import { useEventBus } from './chunk-CHNC4UYE.js';
-import { createContext, useCallback, useSyncExternalStore, useRef, useState, useContext, useEffect, useMemo } from 'react';
+import { DEFAULT_CURRENCY } from './chunk-6ZCU3BQN.js';
+import { en_default } from './chunk-FYX64CDL.js';
+import React, { createContext, useCallback, useSyncExternalStore, useRef, useState, useContext, useEffect, useMemo } from 'react';
+import { mergeEntityFrame, resolvePageMeta } from '@almadar/core';
+import { createLogger } from '@almadar/logger';
 
 function useMediaQuery(query) {
   const subscribe = useCallback(
@@ -549,6 +554,204 @@ function parseQueryBinding(binding) {
     field: parts.length > 1 ? parts.slice(1).join(".") : void 0
   };
 }
+var { $meta: _meta, ...coreMessages } = en_default;
+var coreLocale = coreMessages;
+var { $meta: _arMeta, ...arMessages } = ar_default;
+var { $meta: _slMeta, ...slMessages } = sl_default;
+var uiLocales = { en: coreLocale, ar: arMessages, sl: slMessages };
+var I18nContext = createContext({
+  locale: "en",
+  direction: "ltr",
+  t: (key, params) => {
+    let msg = coreLocale[key] ?? key;
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        msg = msg.split(`{{${k}}}`).join(String(v));
+      }
+    }
+    return msg;
+  }
+});
+I18nContext.displayName = "I18nContext";
+function I18nProvider({ value, children, documentRoot }) {
+  useEffect(() => {
+    if (!documentRoot) return;
+    document.documentElement.lang = value.locale;
+    document.documentElement.dir = value.direction;
+  }, [documentRoot, value.locale, value.direction]);
+  return React.createElement(I18nContext.Provider, { value }, children);
+}
+function useTranslate() {
+  return useContext(I18nContext);
+}
+function useRenderI18n() {
+  const { locale, messages } = useContext(I18nContext);
+  return useMemo(() => messages !== void 0 ? { locale, messages } : void 0, [locale, messages]);
+}
+function useFormatContext() {
+  const { t, locale, currency } = useContext(I18nContext);
+  return useMemo(
+    () => ({ locale, currency: currency ?? DEFAULT_CURRENCY, booleanLabels: { yes: t("common.yes"), no: t("common.no") } }),
+    [t, locale, currency]
+  );
+}
+function createTranslate(messages, locale) {
+  const uiCatalog = locale !== void 0 ? uiLocales[locale] : void 0;
+  return (key, params) => {
+    let msg = messages[key] ?? uiCatalog?.[key] ?? coreLocale[key] ?? key;
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        msg = msg.split(`{{${k}}}`).join(String(v));
+      }
+    }
+    return msg;
+  };
+}
+
+// lib/bus-claim.ts
+var claims = /* @__PURE__ */ new WeakMap();
+function claimDelivery(source, trait, event) {
+  if (source === void 0) return true;
+  const key = `${trait}\0${event}`;
+  const seen = claims.get(source);
+  if (seen === void 0) {
+    claims.set(source, /* @__PURE__ */ new Set([key]));
+    return true;
+  }
+  if (seen.has(key)) return false;
+  seen.add(key);
+  return true;
+}
+var log = createLogger("almadar:ui:shared-entity-store");
+var EMPTY_ENTITY_STATE = {};
+function createSharedEntityStore() {
+  const states = /* @__PURE__ */ new Map();
+  const subscribers = /* @__PURE__ */ new Map();
+  const getSnapshot = (entityId) => states.get(entityId) ?? EMPTY_ENTITY_STATE;
+  const subscribe = (entityId, callback) => {
+    let set = subscribers.get(entityId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      subscribers.set(entityId, set);
+    }
+    set.add(callback);
+    return () => {
+      const current = subscribers.get(entityId);
+      if (!current) return;
+      current.delete(callback);
+      if (current.size === 0) {
+        subscribers.delete(entityId);
+      }
+    };
+  };
+  const commit = (entityId, nextState) => {
+    states.set(entityId, nextState);
+    const set = subscribers.get(entityId);
+    if (!set) return;
+    set.forEach((callback) => {
+      try {
+        callback();
+      } catch (error) {
+        log.error("Shared entity subscriber error", {
+          entityId,
+          error: error instanceof Error ? error : String(error)
+        });
+      }
+    });
+  };
+  const seed = (entityId, initialState) => {
+    if (!states.has(entityId)) {
+      states.set(entityId, initialState);
+    }
+  };
+  return { getSnapshot, subscribe, commit, seed };
+}
+function useSharedEntityStore() {
+  const storeRef = useRef(null);
+  if (storeRef.current === null) {
+    storeRef.current = createSharedEntityStore();
+  }
+  return storeRef.current;
+}
+var SharedEntityStoreContext = createContext(null);
+function useSharedEntityStoreContext() {
+  const store = useContext(SharedEntityStoreContext);
+  if (!store) {
+    throw new Error(
+      "useSharedEntityStoreContext: no SharedEntityStoreContext.Provider found in the component tree"
+    );
+  }
+  return store;
+}
+function useSharedEntitySnapshot(store, entityId) {
+  return useSyncExternalStore(
+    (onStoreChange) => store.subscribe(entityId, onStoreChange),
+    () => store.getSnapshot(entityId)
+  );
+}
+function runTickFrame(entityId, orderedWriters, store) {
+  let scratch = store.getSnapshot(entityId);
+  for (const writer of orderedWriters) {
+    const writes = writer(scratch);
+    scratch = mergeEntityFrame(scratch, writes);
+  }
+  store.commit(entityId, scratch);
+  return scratch;
+}
+var OWNED = "data-orb-head";
+var shellTitle;
+function ownedTag(tag, attrs) {
+  const el = document.createElement(tag);
+  for (const [k, v] of Object.entries(attrs)) el.setAttribute(k, v);
+  el.setAttribute(OWNED, "");
+  return el;
+}
+function usePageHead(input) {
+  const { messages, locale } = useTranslate();
+  const title = input ? resolvePageMeta(input.title, (k) => messages?.[k]) : void 0;
+  const description = input ? resolvePageMeta(input.description, (k) => messages?.[k]) : void 0;
+  const isPublic = input?.access !== "authenticated" && input?.indexing !== "noindex";
+  const canonical = input?.origin !== void 0 ? `${input.origin.replace(/\/+$/, "")}${input.path}` : void 0;
+  const siteName = input?.siteName;
+  const active = input !== null;
+  const originBase = input?.origin?.replace(/\/+$/, "");
+  const hreflang = [];
+  if (originBase !== void 0) {
+    for (const alt of input?.alternates ?? []) hreflang.push([alt.locale, `${originBase}${alt.path}`]);
+    const fallback = input?.alternates?.find((alt) => alt.locale === input.defaultLocale);
+    if (fallback !== void 0) hreflang.push(["x-default", `${originBase}${fallback.path}`]);
+  }
+  const hreflangKey = hreflang.map(([lang, href]) => `${lang} ${href}`).join("\n");
+  useEffect(() => {
+    if (!active || typeof document === "undefined") return void 0;
+    shellTitle ?? (shellTitle = document.title);
+    document.title = title ?? siteName ?? shellTitle;
+    const tags = [];
+    if (!isPublic) tags.push(ownedTag("meta", { name: "robots", content: "noindex" }));
+    if (isPublic && description !== void 0) {
+      tags.push(ownedTag("meta", { name: "description", content: description }));
+      tags.push(ownedTag("meta", { property: "og:description", content: description }));
+    }
+    if (isPublic && title !== void 0) tags.push(ownedTag("meta", { property: "og:title", content: title }));
+    if (isPublic && canonical !== void 0) {
+      tags.push(ownedTag("link", { rel: "canonical", href: canonical }));
+      tags.push(ownedTag("meta", { property: "og:url", content: canonical }));
+    }
+    if (isPublic && siteName !== void 0) tags.push(ownedTag("meta", { property: "og:site_name", content: siteName }));
+    if (isPublic) tags.push(ownedTag("meta", { property: "og:locale", content: locale }));
+    if (isPublic && hreflangKey !== "") {
+      for (const line of hreflangKey.split("\n")) {
+        const space = line.indexOf(" ");
+        tags.push(ownedTag("link", { rel: "alternate", hreflang: line.slice(0, space), href: line.slice(space + 1) }));
+      }
+    }
+    for (const stale of Array.from(document.head.querySelectorAll(`[${OWNED}]`))) stale.remove();
+    for (const tag of tags) document.head.appendChild(tag);
+    return () => {
+      for (const tag of tags) tag.remove();
+    };
+  }, [active, title, description, isPublic, canonical, siteName, locale, hreflangKey]);
+}
 function usePullToRefresh(onRefresh, options = {}) {
   const { threshold = 60, maxPull = 120 } = options;
   const [pullDistance, setPullDistance] = useState(0);
@@ -678,4 +881,4 @@ function useDragReorder(initialItems, onReorder) {
   };
 }
 
-export { ALMADAR_DND_MIME, PendingScopeContext, beginPending, endPending, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useDraggable, useDropZone, useInfiniteScroll, useLongPress, useMediaQuery, usePendingAction, usePendingRows, usePendingScopeValue, usePrefersReducedMotion, usePullToRefresh, useQuerySingleton, useScopeHasPending, useSwipeGesture };
+export { ALMADAR_DND_MIME, I18nProvider, PendingScopeContext, SharedEntityStoreContext, beginPending, claimDelivery, createSharedEntityStore, createTranslate, endPending, parseQueryBinding, runTickFrame, useAuthContext, useCanvasGestures, useDragReorder, useDraggable, useDropZone, useFormatContext, useInfiniteScroll, useLongPress, useMediaQuery, usePageHead, usePendingAction, usePendingRows, usePendingScopeValue, usePrefersReducedMotion, usePullToRefresh, useQuerySingleton, useRenderI18n, useScopeHasPending, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTranslate };

package/dist/{chunk-V3FGTQUE.js → chunk-ZR45FGW3.js}

@@ -134,7 +134,13 @@ var SURFACE_VARS = [
   { cssVar: "--surface-card-image", key: "cardImage" },
   { cssVar: "--surface-page-image", key: "pageImage" },
   { cssVar: "--surface-page-image-size", key: "pageImageSize" },
-  { cssVar: "--surface-diagram", key: "diagram" }
+  { cssVar: "--surface-diagram", key: "diagram" },
+  { cssVar: "--surface-edge-mask", key: "edgeMask" },
+  { cssVar: "--surface-edge-height", key: "edgeHeight" },
+  { cssVar: "--surface-texture-mask", key: "textureMask" },
+  { cssVar: "--surface-texture-size", key: "textureSize" },
+  { cssVar: "--surface-accent-image", key: "accentImage" },
+  { cssVar: "--surface-scrim", key: "scrim" }
 ];
 var DIAGRAM_VARS = [
   { cssVar: "--diagram-stroke-thin", key: "strokeThin" },

package/dist/{cn-DIql5232.d.ts → cn-CDIhHCUC.d.ts}

@@ -135,12 +135,14 @@ declare const BloomQuizBlock: React__default.FC<BloomQuizBlockProps>;
 /**
  * CodeRunnerPanel Organism Component
  *
- * Editable code block with Run/Reset buttons and simulated terminal output.
- * Real execution is a future concern; callers supply a simulation function via
- * `onRun`. Emits `UI:RUN_CODE { language, exitCode }` on every run attempt.
+ * Editable code block with Run/Reset buttons and a terminal output pane.
+ * Running is the program's job: Run emits the declared `runEvent` request and the
+ * program binds the result back through `output` / `running` / `error`.
  *
  * Event Contract:
- * - Emits: UI:RUN_CODE { language, exitCode, error? }
+ * - Emits: UI:<runEvent> { code, language, runId? } on Run
+ * - Emits: UI:<resetEvent> { runId? } on Reset (when declared)
+ * - Emits: UI:COPY_CODE { language, success } on Copy
  * - entityAware: false
  */
 
@@ -160,16 +162,26 @@ interface CodeRunnerPanelProps extends Omit<React__default.AriaAttributes, keyof
     code: string;
     /** Programming language for syntax highlighting */
     language: string;
-    /** Whether the panel allows running (false = read-only code block) */
+    /** Whether the panel is editable and runnable (default false = read-only code block) */
     runnable?: boolean;
-    /**
-     * Simulate executing the code. Omit to render a read-only block.
-     * Real execution is a separate future track — this callback supplies
-     * deterministic simulated output for UI feedback.
-     */
-    onRun?: (code: string) => Promise<CodeSimulationOutput>;
-    /** Event name to emit on run (emitted as `UI:<runEvent>`). Defaults to 'RUN_CODE'. */
-    runEvent?: string;
+    /** Event emitted on Run as `UI:<runEvent>` with `{ code, language, runId }`. Defaults to 'RUN_CODE'. */
+    runEvent?: EventEmit<{
+        code: string;
+        language: string;
+        runId: string;
+    }>;
+    /** Event emitted on Reset as `UI:<resetEvent>` with `{ runId }`; Reset only restores the code when absent. */
+    resetEvent?: EventEmit<{
+        runId: string;
+    }>;
+    /** Identifies this panel in its run/reset payloads (e.g. a lesson segment); empty when one panel stands alone. */
+    runId?: string;
+    /** The program's result for the last run, bound back into the panel. */
+    output?: CodeSimulationOutput | null;
+    /** True while the program is running the code. */
+    running?: boolean;
+    /** A run failure message from the program; replaces the output body. */
+    error?: string | null;
     /** Additional CSS classes */
     className?: string;
 }
@@ -280,10 +292,22 @@ interface SegmentRendererProps extends Omit<React__default.AriaAttributes, keyof
     /** User progress for restoring activation/reflection state */
     userProgress?: LessonUserProgress;
     /**
-     * Simulate executing runnable code blocks. Omit to render runnable blocks
-     * as read-only. Real execution is a future track.
+     * Event a runnable code block emits on Run (`{ code, language, runId }`, runId = the segment
+     * index). Omit to render runnable blocks read-only.
      */
-    onRunCodeSimulation?: (code: string, language: string) => Promise<CodeSimulationOutput>;
+    runCodeEvent?: EventEmit<{
+        code: string;
+        language: string;
+        runId: string;
+    }>;
+    /** Event a runnable code block emits on Reset (`{ runId }`). */
+    resetCodeEvent?: EventEmit<{
+        runId: string;
+    }>;
+    /** The program's run results, keyed by segment runId. */
+    codeOutputs?: Record<string, CodeSimulationOutput>;
+    /** The runId the program is currently running. */
+    runningCode?: string;
     /**
      * Optional render slot for `visualization` segment types. When not provided,
      * visualization segments are silently skipped. Callers can wire this to any