@jay-framework/runtime 0.8.0 → 0.10.0

package/dist/index.d.ts

@@ -65,14 +65,20 @@ type JayEventHandlerWrapper<EventType, ViewState, Returns> = (orig: JayEventHand
 interface ContextMarker<ContextType> {
 }
 declare const _jayContractBrand: unique symbol;
-type JayContract<ViewState extends object, Refs extends object> = {
+type JayContract<ViewState extends object, Refs extends object, SlowViewState extends object = never, FastViewState extends object = never, InteractiveViewState extends object = never> = {
     readonly [_jayContractBrand]: {
         viewState: ViewState;
         refs: Refs;
+        slowViewState: SlowViewState;
+        fastViewState: FastViewState;
+        interactiveViewState: InteractiveViewState;
     };
 };
-type ExtractViewState<A> = A extends JayContract<infer ViewState, any> ? ViewState : never;
-type ExtractRefs<A> = A extends JayContract<any, infer Refs> ? Refs : never;
+type ExtractViewState<A> = A extends JayContract<infer ViewState, any, any, any, any> ? ViewState : never;
+type ExtractRefs<A> = A extends JayContract<any, infer Refs, any, any, any> ? Refs : never;
+type ExtractSlowViewState<A> = A extends JayContract<any, any, infer SlowViewState, any, any> ? SlowViewState : never;
+type ExtractFastViewState<A> = A extends JayContract<any, any, any, infer FastViewState, any> ? FastViewState : never;
+type ExtractInteractiveViewState<A> = A extends JayContract<any, any, any, any, infer InteractiveViewState> ? InteractiveViewState : never;
 declare enum LogType {
     ASYNC_ERROR = 0,
     CONTEXT_NOT_FOUND = 1
@@ -496,6 +502,35 @@ interface ContextStack<ContextType> {
     marker: ContextMarker<ContextType>;
     parent?: ContextStack<any>;
 }
+/**
+ * Registers a global context that will be available to all components.
+ * Global contexts are checked after the context stack, so component-provided
+ * contexts can override global ones.
+ *
+ * @param marker - The context marker created with createJayContext()
+ * @param context - The context value to register
+ *
+ * @example
+ * ```typescript
+ * // In lib/init.ts (using makeJayInit pattern)
+ * export const init = makeJayInit()
+ *   .withServer(() => ({ itemsPerPage: 10 }))
+ *   .withClient((serverData) => {
+ *     registerGlobalContext(APP_CONFIG_CONTEXT, serverData);
+ *   });
+ * ```
+ */
+declare function registerGlobalContext<ContextType>(marker: ContextMarker<ContextType>, context: ContextType): void;
+/**
+ * Clears all registered global contexts.
+ * Internal API for testing and hot reload.
+ */
+declare function clearGlobalContextRegistry(): void;
+/**
+ * Gets a global context by marker.
+ * Internal API used by findContext.
+ */
+declare function useGlobalContext<ContextType>(marker: ContextMarker<ContextType>): ContextType | undefined;
 declare function createJayContext<ContextType = unknown>(): ContextMarker<ContextType>;
 declare function withContext<ContextType, Returns>(marker: ContextMarker<ContextType>, context: ContextType, callback: () => Returns): Returns;
 declare function useContext<ContextType>(marker: ContextMarker<ContextType>): ContextType;
@@ -515,4 +550,4 @@ declare class ConstructContext<ViewState> {
     static withRootContext<ViewState, Refs>(viewState: ViewState, refManager: ReferencesManager, elementConstructor: () => BaseJayElement<ViewState>): JayElement<ViewState, Refs>;
 }
 
-export { type Attribute, type Attributes, type BaseJayElement, BaseReferencesManager, type ComponentCollectionProxy, ComponentCollectionRefImpl, type ComponentProxy, ComponentRefImpl, ComponentRefsImpl, type Conditional, ConstructContext, type ContextMarker, type Coordinate, type DynamicAttributeOrProperty, EVENT_TRAP, type ElementFrom, type EventEmitter, type EventTypeFrom, type ExtractRefs, type ExtractViewState, type ForEach, GetTrapProxy, type GlobalJayEvents, type HTMLElementCollectionProxy, type HTMLElementCollectionProxyTarget, type HTMLElementProxy, type HTMLElementProxyTarget, type HTMLNativeExec, type HeadLink, type JayComponent, type JayComponentConstructor, type JayContract, type JayElement, type JayEvent, type JayEventHandler, type JayEventHandlerWrapper, type JayLog, type JayNativeEventBuilder, type JayNativeFunction, LogType, type ManagedRefConstructor, ManagedRefType, type ManagedRefs, type MapEventEmitterViewState, type MountFunc, type OnlyEventEmitters, type PreRenderElement, type PrivateRef, type PrivateRefConstructor, PrivateRefs, type PropsFrom, ReferencesManager, type RenderElement, type RenderElementOptions, type TextElement, type ViewStateFrom, type When, WhenRole, type WithData, booleanAttribute, childComp, conditional, createJayContext, currentConstructionContext, defaultEventWrapper, dynamicAttribute, dynamicElement, dynamicElementNS, dynamicProperty, dynamicText, element, findContext, forEach, injectHeadLinks, isCondition, isForEach, isWhen, isWithData, jayLog, mathMLDynamicElement, mathMLElement, mkUpdateCollection, noop, noopMount, noopUpdate, normalizeMount, normalizeUpdates, pending, rejected, resolved, restoreContext, saveContext, svgDynamicElement, svgElement, type updateFunc, useContext, withContext, withData };
+export { type Attribute, type Attributes, type BaseJayElement, BaseReferencesManager, type ComponentCollectionProxy, ComponentCollectionRefImpl, type ComponentProxy, ComponentRefImpl, ComponentRefsImpl, type Conditional, ConstructContext, type ContextMarker, type Coordinate, type DynamicAttributeOrProperty, EVENT_TRAP, type ElementFrom, type EventEmitter, type EventTypeFrom, type ExtractFastViewState, type ExtractInteractiveViewState, type ExtractRefs, type ExtractSlowViewState, type ExtractViewState, type ForEach, GetTrapProxy, type GlobalJayEvents, type HTMLElementCollectionProxy, type HTMLElementCollectionProxyTarget, type HTMLElementProxy, type HTMLElementProxyTarget, type HTMLNativeExec, type HeadLink, type JayComponent, type JayComponentConstructor, type JayContract, type JayElement, type JayEvent, type JayEventHandler, type JayEventHandlerWrapper, type JayLog, type JayNativeEventBuilder, type JayNativeFunction, LogType, type ManagedRefConstructor, ManagedRefType, type ManagedRefs, type MapEventEmitterViewState, type MountFunc, type OnlyEventEmitters, type PreRenderElement, type PrivateRef, type PrivateRefConstructor, PrivateRefs, type PropsFrom, ReferencesManager, type RenderElement, type RenderElementOptions, type TextElement, type ViewStateFrom, type When, WhenRole, type WithData, booleanAttribute, childComp, clearGlobalContextRegistry, conditional, createJayContext, currentConstructionContext, defaultEventWrapper, dynamicAttribute, dynamicElement, dynamicElementNS, dynamicProperty, dynamicText, element, findContext, forEach, injectHeadLinks, isCondition, isForEach, isWhen, isWithData, jayLog, mathMLDynamicElement, mathMLElement, mkUpdateCollection, noop, noopMount, noopUpdate, normalizeMount, normalizeUpdates, pending, registerGlobalContext, rejected, resolved, restoreContext, saveContext, svgDynamicElement, svgElement, type updateFunc, useContext, useGlobalContext, withContext, withData };

package/dist/index.js

@@ -97,6 +97,16 @@ let currentContext = void 0;
 function NewContextStack(context, marker, parent) {
   return { context, marker, parent };
 }
+const globalContextRegistry = /* @__PURE__ */ new Map();
+function registerGlobalContext(marker, context) {
+  globalContextRegistry.set(marker, context);
+}
+function clearGlobalContextRegistry() {
+  globalContextRegistry.clear();
+}
+function useGlobalContext(marker) {
+  return globalContextRegistry.get(marker);
+}
 function createJayContext() {
   return Symbol();
 }
@@ -122,6 +132,11 @@ function findContext(predicate) {
       return aContext.context;
     aContext = aContext.parent;
   }
+  for (const [marker, context] of globalContextRegistry.entries()) {
+    if (predicate(marker)) {
+      return context;
+    }
+  }
   return void 0;
 }
 function saveContext() {
@@ -983,6 +998,7 @@ export {
   WhenRole,
   booleanAttribute,
   childComp,
+  clearGlobalContextRegistry,
   conditional,
   createJayContext,
   currentConstructionContext,
@@ -1010,6 +1026,7 @@ export {
   normalizeMount,
   normalizeUpdates,
   pending,
+  registerGlobalContext,
   rejected,
   resolved,
   restoreContext,
@@ -1017,6 +1034,7 @@ export {
   svgDynamicElement,
   svgElement,
   useContext,
+  useGlobalContext,
   withContext,
   withData
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/runtime",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -23,11 +23,11 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/list-compare": "^0.8.0",
-    "@jay-framework/reactive": "^0.8.0"
+    "@jay-framework/list-compare": "^0.10.0",
+    "@jay-framework/reactive": "^0.10.0"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.8.0",
+    "@jay-framework/dev-environment": "^0.10.0",
     "@testing-library/jest-dom": "^6.2.0",
     "@types/jsdom": "^21.1.6",
     "@types/node": "^20.11.5",