@almadar/ui 6.15.0 → 6.17.0

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-EJoTtuTR.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-EJoTtuTR.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-Dglbi9ks.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-Dglbi9ks.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
@@ -52,7 +52,9 @@ interface UseTraitStateMachineOptions {
      * local state). `sourceTrait` is the emitting trait, for the
      * server relay's BusEventSource.
      */
-    tick?: string, sourceTrait?: string) => void | Promise<void>;
+    tick?: string, sourceTrait?: string, 
+    /** Every event name this dispatch's local effect execution emitted, one entry per emit (multiplicity matters — see `stampLocallyDeliveredEchoes`). */
+    locallyEmitted?: readonly string[]) => void | Promise<void>;
     /** Router navigate function for navigate effects. `crumb` labels the
      * target page's navigation-stack entry (from the effect's options). */
     navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;
@@ -220,6 +222,8 @@ interface CreateClientEffectHandlersOptions {
      * it (the hook always binds one for `(set @entity.X)`).
      */
     persistDelegated?: boolean;
+    /** Same bridge-mode delegation as `persistDelegated`, for `(call-service …)`: set when no consumer `callService` is wired, so the executor skips the mock fallback below and the server's cascade carries the result. */
+    callServiceDelegated?: boolean;
     /**
      * Optional consumer-supplied call-service handler. When set, it runs
      * instead of the default mock fallback — use to wire the playground
@@ -289,6 +293,12 @@ interface OrbPreviewProps {
      * Default false (standalone previews own the global bridge).
      */
     isolated?: boolean;
+    /**
+     * Scale the rendered content down (never up) so it fits the container
+     * without scrollbars. For fixed-intrinsic-size content (game canvases);
+     * leave off for flow layouts, which should keep their internal scroll.
+     */
+    fit?: boolean;
 }
 /**
  * Renders a live preview of an Orbital schema.
@@ -303,7 +313,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, user, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, fit, user, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }
@@ -340,8 +350,10 @@ interface BrowserPlaygroundProps {
     className?: string;
     /** Pause the in-process runtime's tick scheduler. Default: undefined (running, same as today). */
     paused?: boolean;
+    /** Scale content down (never up) to fit the container without scrollbars — for fixed-size content like game canvases. Forwarded to OrbPreview. */
+    fit?: boolean;
 }
-declare function BrowserPlayground({ schema, mode, initialPagePath, height, className, paused, }: BrowserPlaygroundProps): React__default.ReactElement;
+declare function BrowserPlayground({ schema, mode, initialPagePath, height, className, paused, fit, }: BrowserPlaygroundProps): React__default.ReactElement;
 
 /**
  * OrbitalPluginHost — runs an ordinary behavior headless against the

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-EJoTtuTR.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-EJoTtuTR.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-Dglbi9ks.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-Dglbi9ks.js';
 import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
@@ -52,7 +52,9 @@ interface UseTraitStateMachineOptions {
      * local state). `sourceTrait` is the emitting trait, for the
      * server relay's BusEventSource.
      */
-    tick?: string, sourceTrait?: string) => void | Promise<void>;
+    tick?: string, sourceTrait?: string, 
+    /** Every event name this dispatch's local effect execution emitted, one entry per emit (multiplicity matters — see `stampLocallyDeliveredEchoes`). */
+    locallyEmitted?: readonly string[]) => void | Promise<void>;
     /** Router navigate function for navigate effects. `crumb` labels the
      * target page's navigation-stack entry (from the effect's options). */
     navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;
@@ -220,6 +222,8 @@ interface CreateClientEffectHandlersOptions {
      * it (the hook always binds one for `(set @entity.X)`).
      */
     persistDelegated?: boolean;
+    /** Same bridge-mode delegation as `persistDelegated`, for `(call-service …)`: set when no consumer `callService` is wired, so the executor skips the mock fallback below and the server's cascade carries the result. */
+    callServiceDelegated?: boolean;
     /**
      * Optional consumer-supplied call-service handler. When set, it runs
      * instead of the default mock fallback — use to wire the playground
@@ -289,6 +293,12 @@ interface OrbPreviewProps {
      * Default false (standalone previews own the global bridge).
      */
     isolated?: boolean;
+    /**
+     * Scale the rendered content down (never up) so it fits the container
+     * without scrollbars. For fixed-intrinsic-size content (game canvases);
+     * leave off for flow layouts, which should keep their internal scroll.
+     */
+    fit?: boolean;
 }
 /**
  * Renders a live preview of an Orbital schema.
@@ -303,7 +313,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, user, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, fit, user, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }
@@ -340,8 +350,10 @@ interface BrowserPlaygroundProps {
     className?: string;
     /** Pause the in-process runtime's tick scheduler. Default: undefined (running, same as today). */
     paused?: boolean;
+    /** Scale content down (never up) to fit the container without scrollbars — for fixed-size content like game canvases. Forwarded to OrbPreview. */
+    fit?: boolean;
 }
-declare function BrowserPlayground({ schema, mode, initialPagePath, height, className, paused, }: BrowserPlaygroundProps): React__default.ReactElement;
+declare function BrowserPlayground({ schema, mode, initialPagePath, height, className, paused, fit, }: BrowserPlaygroundProps): React__default.ReactElement;
 
 /**
  * OrbitalPluginHost — runs an ordinary behavior headless against the