@almadar/ui 6.10.0 → 6.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/dist/{EntityBindingContext-Y4zXyNJZ.d.cts → EntityBindingContext-D5lRu6p1.d.cts} +11 -0
  2. package/dist/{EntityBindingContext-Y4zXyNJZ.d.ts → EntityBindingContext-D5lRu6p1.d.ts} +11 -0
  3. package/dist/{GameAudioProvider-Dk_Y3LN3.d.cts → GameAudioProvider-D8GynTNq.d.cts} +1 -1
  4. package/dist/{GameAudioProvider-Ctceau1s.d.ts → GameAudioProvider-Dozqx4sL.d.ts} +1 -1
  5. package/dist/avl/index.cjs +250 -106
  6. package/dist/avl/index.js +209 -65
  7. package/dist/{avl-schema-parser-DncJLEn9.d.ts → avl-schema-parser-DX-aVCCm.d.ts} +1 -1
  8. package/dist/{avl-schema-parser-FQ1474v8.d.cts → avl-schema-parser-PVu8rgsy.d.cts} +1 -1
  9. package/dist/{cn-C7fvp9gH.d.ts → cn-Do5gsPBm.d.cts} +2 -100
  10. package/dist/{cn-DnLYahyL.d.cts → cn-Do5gsPBm.d.ts} +2 -100
  11. package/dist/components/index.cjs +103 -68
  12. package/dist/components/index.d.cts +44 -20
  13. package/dist/components/index.d.ts +44 -20
  14. package/dist/components/index.js +64 -29
  15. package/dist/lib/drawable/three/index.d.cts +3 -4
  16. package/dist/lib/drawable/three/index.d.ts +3 -4
  17. package/dist/lib/index.cjs +7 -23
  18. package/dist/lib/index.d.cts +6 -28
  19. package/dist/lib/index.d.ts +6 -28
  20. package/dist/lib/index.js +5 -23
  21. package/dist/{paintDispatch-B5ObLnUv.d.ts → paintDispatch-CK5uwYEq.d.cts} +50 -3
  22. package/dist/{paintDispatch-D3R8NNmV.d.cts → paintDispatch-CK5uwYEq.d.ts} +50 -3
  23. package/dist/providers/index.cjs +129 -78
  24. package/dist/providers/index.d.cts +5 -3
  25. package/dist/providers/index.d.ts +5 -3
  26. package/dist/providers/index.js +90 -39
  27. package/dist/runtime/index.cjs +249 -105
  28. package/dist/runtime/index.d.cts +27 -5
  29. package/dist/runtime/index.d.ts +27 -5
  30. package/dist/runtime/index.js +208 -64
  31. package/dist/verificationRegistry-BLsjb1oU.d.cts +110 -0
  32. package/dist/verificationRegistry-D8bHWD8Q.d.ts +110 -0
  33. package/package.json +7 -7
  34. package/dist/types-B3nHgnMG.d.cts +0 -51
  35. package/dist/types-B3nHgnMG.d.ts +0 -51
@@ -1,6 +1,5 @@
1
- import { OrbitalSchema, SExpr, Effect, OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, ServerResponseTrace, CheckStatus, AssetLoadStatus } from '@almadar/core';
1
+ import { OrbitalSchema, SExpr, Effect } from '@almadar/core';
2
2
  import React__default from 'react';
3
- import { D as DrawableNode } from './paintDispatch-B5ObLnUv.js';
4
3
  import { ClassValue } from 'clsx';
5
4
 
6
5
  /**
@@ -324,107 +323,10 @@ declare function extractStateMachine(data: OrbitalSchema | object): StateMachine
324
323
  */
325
324
  declare function renderStateMachineToDomData(stateMachine: StateMachineDefinition, options?: RenderOptions, config?: VisualizerConfig): DomLayoutData;
326
325
 
327
- /**
328
- * Verification Registry - Tracks runtime verification checks and transition traces
329
- *
330
- * Provides:
331
- * 1. A checklist of pass/fail checks (INIT has fetch, bridge connected, etc.)
332
- * 2. A full transition timeline with effect execution results
333
- * 3. ServerBridge health snapshot
334
- * 4. window.__orbitalVerification for Playwright/automation
335
- *
336
- * @packageDocumentation
337
- */
338
-
339
- type ChangeListener = () => void;
340
- /**
341
- * Per-trait snapshot getter. Each generated trait logic hook (or
342
- * `useTraitStateMachine` trait binding) registers one on mount so the
343
- * verifier can read the live reducer state for that trait.
344
- */
345
- type TraitSnapshotGetter = () => TraitStateSnapshot;
346
- declare function registerCheck(id: string, label: string, status?: CheckStatus, details?: string): void;
347
- declare function updateCheck(id: string, status: CheckStatus, details?: string): void;
348
- declare function getAllChecks(): VerificationCheck[];
349
- declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
350
- declare function getTransitions(): TransitionTrace[];
351
- declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
352
- /**
353
- * Record a server response as a timeline entry.
354
- * Creates a synthetic transition entry with type "server-response" to show
355
- * what the server returned (clientEffects, data counts, emitted events).
356
- */
357
- declare function recordServerResponse(orbitalName: string, event: string, response: Omit<ServerResponseTrace, "orbitalName" | "timestamp">): void;
358
- declare function updateBridgeHealth(health: BridgeHealth): void;
359
- declare function getBridgeHealth(): BridgeHealth | null;
360
- declare function getSummary(): VerificationSummary;
361
- declare function getSnapshot(): VerificationSnapshot;
362
- /**
363
- * Per-trait snapshot for the verifier.
364
- *
365
- * Iterates every registered trait getter and collects the live reducer
366
- * state. Empty until at least one trait hook calls `registerTraitSnapshot`.
367
- * A getter that throws is logged and skipped — one broken trait must not
368
- * poison the rest of the snapshot.
369
- */
370
- declare function getTraitSnapshots(): TraitStateSnapshot[];
371
- declare function subscribeToVerification(listener: ChangeListener): () => void;
372
- declare global {
373
- interface Window {
374
- __orbitalVerification?: OrbitalVerificationAPI;
375
- }
376
- }
377
- /**
378
- * Wait for a transition matching the given event to appear.
379
- * Returns the trace or null on timeout.
380
- */
381
- declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
382
- /**
383
- * Bind the EventBus so automation can send events and log emissions.
384
- * Call this during app initialization.
385
- */
386
- declare function bindEventBus(eventBus: {
387
- emit: (type: string, payload?: EventPayload) => void;
388
- onAny?: (listener: (event: BusEvent) => void) => () => void;
389
- }): void;
390
- /**
391
- * Bind a trait state getter so automation can query current states.
392
- */
393
- declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
394
- /**
395
- * Register a per-trait snapshot provider. The generated trait logic hook
396
- * (or `useTraitStateMachine`) calls this once on mount, passing a getter
397
- * that reads the current reducer state via a ref. Returns an unregister
398
- * function for cleanup on unmount.
399
- *
400
- * Calling this twice for the same `traitName` replaces the previous
401
- * getter (e.g. page navigation remounts the trait; the new registration
402
- * wins).
403
- */
404
- declare function registerTraitSnapshot(traitName: string, getter: TraitSnapshotGetter): () => void;
405
- /**
406
- * Register a canvas frame capture function.
407
- * Called by game organisms (IsometricCanvas, PlatformerCanvas)
408
- * so the verifier can snapshot canvas content at checkpoints.
409
- */
410
- declare function bindCanvasCapture(captureFn: () => string | null): void;
411
- /**
412
- * Bind a reader for the last drawables list received by a canvas host.
413
- * Lets verification scripts inspect exactly which neutral descriptors reached
414
- * the painter without re-deriving them from state.
415
- */
416
- declare function bindLastDrawables(getDrawables: () => DrawableNode[] | null): void;
417
- /**
418
- * Update asset load status for canvas verification.
419
- * Game organisms call this when images load or fail.
420
- */
421
- declare function updateAssetStatus(url: string, status: AssetLoadStatus): void;
422
- declare function clearVerification(): void;
423
-
424
326
  /**
425
327
  * Utility function to merge Tailwind CSS classes
426
328
  * Combines clsx for conditional classes with tailwind-merge to handle conflicts
427
329
  */
428
330
  declare function cn(...inputs: ClassValue[]): string;
429
331
 
430
- export { renderStateMachineToSvg as $, type ApplyOperatorInput as A, getEffectSummary as B, type ContentSegment as C, DEFAULT_CONFIG as D, EDITOR_MOTIONS as E, getSnapshot as F, getSummary as G, getTraitSnapshots as H, INDENT_UNIT as I, getTransitions as J, getTransitionsForTrait as K, type LessonSegment as L, isEditorMotion as M, isEditorOperator as N, motionRange as O, parseContentSegments as P, parseLessonSegments as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, parseMarkdownWithCodeBlocks$1 as U, type VisualizerConfig as V, recordServerResponse as W, recordTransition as X, registerCheck as Y, registerTraitSnapshot as Z, renderStateMachineToDomData as _, type ApplyOperatorResult as a, subscribeToVerification as a0, updateAssetStatus as a1, updateBridgeHealth as a2, updateCheck as a3, waitForTransition as a4, type InteractiveOrbitalType as a5, type BloomLevel as a6, BloomQuizBlock as a7, type BloomQuizBlockProps as a8, type MixedSegment as a9, parseMarkdownWithCodeBlocks as aa, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, EDITOR_OPERATORS as h, type EditorMotion as i, type EditorOperator as j, type EntityDefinition as k, type StateMachineDefinition as l, type TransitionDefinition as m, applyMotion as n, applyOperator as o, bindCanvasCapture as p, bindEventBus as q, bindLastDrawables as r, bindTraitStateGetter as s, clearVerification as t, cn as u, extractOutputsFromTransitions as v, extractStateMachine as w, formatGuard as x, getAllChecks as y, getBridgeHealth as z };
332
+ export { type ApplyOperatorInput as A, renderStateMachineToSvg as B, type ContentSegment as C, DEFAULT_CONFIG as D, EDITOR_MOTIONS as E, type InteractiveOrbitalType as F, type BloomLevel as G, BloomQuizBlock as H, INDENT_UNIT as I, type BloomQuizBlockProps as J, parseMarkdownWithCodeBlocks as K, type LessonSegment as L, type MixedSegment as M, type RenderOptions as R, type StateDefinition as S, type TransitionDefinition as T, type VisualizerConfig as V, type ApplyOperatorResult as a, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, EDITOR_OPERATORS as h, type EditorMotion as i, type EditorOperator as j, type EntityDefinition as k, type StateMachineDefinition as l, applyMotion as m, applyOperator as n, cn as o, extractOutputsFromTransitions as p, extractStateMachine as q, formatGuard as r, getEffectSummary as s, isEditorMotion as t, isEditorOperator as u, motionRange as v, parseContentSegments as w, parseLessonSegments as x, parseMarkdownWithCodeBlocks$1 as y, renderStateMachineToDomData as z };
@@ -1,6 +1,5 @@
1
- import { OrbitalSchema, SExpr, Effect, OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, ServerResponseTrace, CheckStatus, AssetLoadStatus } from '@almadar/core';
1
+ import { OrbitalSchema, SExpr, Effect } from '@almadar/core';
2
2
  import React__default from 'react';
3
- import { D as DrawableNode } from './paintDispatch-D3R8NNmV.cjs';
4
3
  import { ClassValue } from 'clsx';
5
4
 
6
5
  /**
@@ -324,107 +323,10 @@ declare function extractStateMachine(data: OrbitalSchema | object): StateMachine
324
323
  */
325
324
  declare function renderStateMachineToDomData(stateMachine: StateMachineDefinition, options?: RenderOptions, config?: VisualizerConfig): DomLayoutData;
326
325
 
327
- /**
328
- * Verification Registry - Tracks runtime verification checks and transition traces
329
- *
330
- * Provides:
331
- * 1. A checklist of pass/fail checks (INIT has fetch, bridge connected, etc.)
332
- * 2. A full transition timeline with effect execution results
333
- * 3. ServerBridge health snapshot
334
- * 4. window.__orbitalVerification for Playwright/automation
335
- *
336
- * @packageDocumentation
337
- */
338
-
339
- type ChangeListener = () => void;
340
- /**
341
- * Per-trait snapshot getter. Each generated trait logic hook (or
342
- * `useTraitStateMachine` trait binding) registers one on mount so the
343
- * verifier can read the live reducer state for that trait.
344
- */
345
- type TraitSnapshotGetter = () => TraitStateSnapshot;
346
- declare function registerCheck(id: string, label: string, status?: CheckStatus, details?: string): void;
347
- declare function updateCheck(id: string, status: CheckStatus, details?: string): void;
348
- declare function getAllChecks(): VerificationCheck[];
349
- declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
350
- declare function getTransitions(): TransitionTrace[];
351
- declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
352
- /**
353
- * Record a server response as a timeline entry.
354
- * Creates a synthetic transition entry with type "server-response" to show
355
- * what the server returned (clientEffects, data counts, emitted events).
356
- */
357
- declare function recordServerResponse(orbitalName: string, event: string, response: Omit<ServerResponseTrace, "orbitalName" | "timestamp">): void;
358
- declare function updateBridgeHealth(health: BridgeHealth): void;
359
- declare function getBridgeHealth(): BridgeHealth | null;
360
- declare function getSummary(): VerificationSummary;
361
- declare function getSnapshot(): VerificationSnapshot;
362
- /**
363
- * Per-trait snapshot for the verifier.
364
- *
365
- * Iterates every registered trait getter and collects the live reducer
366
- * state. Empty until at least one trait hook calls `registerTraitSnapshot`.
367
- * A getter that throws is logged and skipped — one broken trait must not
368
- * poison the rest of the snapshot.
369
- */
370
- declare function getTraitSnapshots(): TraitStateSnapshot[];
371
- declare function subscribeToVerification(listener: ChangeListener): () => void;
372
- declare global {
373
- interface Window {
374
- __orbitalVerification?: OrbitalVerificationAPI;
375
- }
376
- }
377
- /**
378
- * Wait for a transition matching the given event to appear.
379
- * Returns the trace or null on timeout.
380
- */
381
- declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
382
- /**
383
- * Bind the EventBus so automation can send events and log emissions.
384
- * Call this during app initialization.
385
- */
386
- declare function bindEventBus(eventBus: {
387
- emit: (type: string, payload?: EventPayload) => void;
388
- onAny?: (listener: (event: BusEvent) => void) => () => void;
389
- }): void;
390
- /**
391
- * Bind a trait state getter so automation can query current states.
392
- */
393
- declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
394
- /**
395
- * Register a per-trait snapshot provider. The generated trait logic hook
396
- * (or `useTraitStateMachine`) calls this once on mount, passing a getter
397
- * that reads the current reducer state via a ref. Returns an unregister
398
- * function for cleanup on unmount.
399
- *
400
- * Calling this twice for the same `traitName` replaces the previous
401
- * getter (e.g. page navigation remounts the trait; the new registration
402
- * wins).
403
- */
404
- declare function registerTraitSnapshot(traitName: string, getter: TraitSnapshotGetter): () => void;
405
- /**
406
- * Register a canvas frame capture function.
407
- * Called by game organisms (IsometricCanvas, PlatformerCanvas)
408
- * so the verifier can snapshot canvas content at checkpoints.
409
- */
410
- declare function bindCanvasCapture(captureFn: () => string | null): void;
411
- /**
412
- * Bind a reader for the last drawables list received by a canvas host.
413
- * Lets verification scripts inspect exactly which neutral descriptors reached
414
- * the painter without re-deriving them from state.
415
- */
416
- declare function bindLastDrawables(getDrawables: () => DrawableNode[] | null): void;
417
- /**
418
- * Update asset load status for canvas verification.
419
- * Game organisms call this when images load or fail.
420
- */
421
- declare function updateAssetStatus(url: string, status: AssetLoadStatus): void;
422
- declare function clearVerification(): void;
423
-
424
326
  /**
425
327
  * Utility function to merge Tailwind CSS classes
426
328
  * Combines clsx for conditional classes with tailwind-merge to handle conflicts
427
329
  */
428
330
  declare function cn(...inputs: ClassValue[]): string;
429
331
 
430
- export { renderStateMachineToSvg as $, type ApplyOperatorInput as A, getEffectSummary as B, type ContentSegment as C, DEFAULT_CONFIG as D, EDITOR_MOTIONS as E, getSnapshot as F, getSummary as G, getTraitSnapshots as H, INDENT_UNIT as I, getTransitions as J, getTransitionsForTrait as K, type LessonSegment as L, isEditorMotion as M, isEditorOperator as N, motionRange as O, parseContentSegments as P, parseLessonSegments as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, parseMarkdownWithCodeBlocks$1 as U, type VisualizerConfig as V, recordServerResponse as W, recordTransition as X, registerCheck as Y, registerTraitSnapshot as Z, renderStateMachineToDomData as _, type ApplyOperatorResult as a, subscribeToVerification as a0, updateAssetStatus as a1, updateBridgeHealth as a2, updateCheck as a3, waitForTransition as a4, type InteractiveOrbitalType as a5, type BloomLevel as a6, BloomQuizBlock as a7, type BloomQuizBlockProps as a8, type MixedSegment as a9, parseMarkdownWithCodeBlocks as aa, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, EDITOR_OPERATORS as h, type EditorMotion as i, type EditorOperator as j, type EntityDefinition as k, type StateMachineDefinition as l, type TransitionDefinition as m, applyMotion as n, applyOperator as o, bindCanvasCapture as p, bindEventBus as q, bindLastDrawables as r, bindTraitStateGetter as s, clearVerification as t, cn as u, extractOutputsFromTransitions as v, extractStateMachine as w, formatGuard as x, getAllChecks as y, getBridgeHealth as z };
332
+ export { type ApplyOperatorInput as A, renderStateMachineToSvg as B, type ContentSegment as C, DEFAULT_CONFIG as D, EDITOR_MOTIONS as E, type InteractiveOrbitalType as F, type BloomLevel as G, BloomQuizBlock as H, INDENT_UNIT as I, type BloomQuizBlockProps as J, parseMarkdownWithCodeBlocks as K, type LessonSegment as L, type MixedSegment as M, type RenderOptions as R, type StateDefinition as S, type TransitionDefinition as T, type VisualizerConfig as V, type ApplyOperatorResult as a, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, EDITOR_OPERATORS as h, type EditorMotion as i, type EditorOperator as j, type EntityDefinition as k, type StateMachineDefinition as l, applyMotion as m, applyOperator as n, cn as o, extractOutputsFromTransitions as p, extractStateMachine as q, formatGuard as r, getEffectSummary as s, isEditorMotion as t, isEditorOperator as u, motionRange as v, parseContentSegments as w, parseLessonSegments as x, parseMarkdownWithCodeBlocks$1 as y, renderStateMachineToDomData as z };