@jay-framework/stack-client-runtime 0.11.0 → 0.12.0

package/dist/index.cjs

@@ -79,6 +79,23 @@ function mergeArraysByTrackBy$1(baseArray, overlayArray, trackByField, trackByMa
     }
   });
 }
+const HEADLESS_INSTANCES = runtime.createJayContext();
+function makeSignals$1(obj) {
+  return Object.keys(obj).reduce((signals, key) => {
+    signals[key] = component.createSignal(obj[key]);
+    return signals;
+  }, {});
+}
+function makeHeadlessInstanceComponent(preRender, interactiveConstructor, coordinateKey, pluginContexts = []) {
+  const wrappedConstructor = (props, refs, ...pluginResolvedContexts) => {
+    const instanceData = runtime.useContext(HEADLESS_INSTANCES);
+    const fastVS = instanceData?.viewStates?.[coordinateKey];
+    const cf = instanceData?.carryForwards?.[coordinateKey] || {};
+    const signalVS = fastVS ? makeSignals$1(fastVS) : void 0;
+    return interactiveConstructor(props, refs, signalVS, cf, ...pluginResolvedContexts);
+  };
+  return component.makeJayComponent(preRender, wrappedConstructor, ...pluginContexts);
+}
 function makeSignals(obj) {
   return Object.keys(obj).reduce((signals, key) => {
     signals[key] = component.createSignal(obj[key]);
@@ -88,7 +105,21 @@ function makeSignals(obj) {
 function makeCompositeJayComponent(preRender, defaultViewState, fastCarryForward, parts, trackByMap = {}) {
   const interactiveParts = parts.filter((part) => part.comp !== void 0);
   const hasFastRendering = defaultViewState !== null && defaultViewState !== void 0;
+  const headlessInstanceViewStates = defaultViewState?.__headlessInstances;
+  const headlessInstanceCarryForwards = fastCarryForward?.__headlessInstances;
+  if (headlessInstanceViewStates)
+    delete defaultViewState.__headlessInstances;
+  if (headlessInstanceCarryForwards)
+    delete fastCarryForward.__headlessInstances;
   const comp = (props, refs, ...contexts) => {
+    if (headlessInstanceViewStates || headlessInstanceCarryForwards) {
+      const componentContext = runtime.useContext(component.COMPONENT_CONTEXT);
+      const instancesData = {
+        viewStates: headlessInstanceViewStates || {},
+        carryForwards: headlessInstanceCarryForwards || {}
+      };
+      componentContext.provideContexts.push([HEADLESS_INSTANCES, instancesData]);
+    }
     const instances = interactiveParts.map(
       (part) => {
         const partRefs = part.key ? refs[part.key] : refs;
@@ -487,7 +518,9 @@ function wrapWithAutomation(component2, options) {
 const AUTOMATION_CONTEXT = runtime.createJayContext();
 exports.AUTOMATION_CONTEXT = AUTOMATION_CONTEXT;
 exports.ActionError = ActionError;
+exports.HEADLESS_INSTANCES = HEADLESS_INSTANCES;
 exports.createActionCaller = createActionCaller;
 exports.makeCompositeJayComponent = makeCompositeJayComponent;
+exports.makeHeadlessInstanceComponent = makeHeadlessInstanceComponent;
 exports.setActionCallerOptions = setActionCallerOptions;
 exports.wrapWithAutomation = wrapWithAutomation;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _jay_framework_component from '@jay-framework/component';
 import { ComponentConstructor, ContextMarkers, JayComponentCore } from '@jay-framework/component';
-import { JayElement, PreRenderElement } from '@jay-framework/runtime';
+import { JayElement, PreRenderElement, ContextMarker } from '@jay-framework/runtime';
 import { TrackByMap } from '@jay-framework/view-state-merge';
 export { AUTOMATION_CONTEXT, AutomationAPI, AutomationWrappedComponent, Coordinate, Interaction, PageState, wrapWithAutomation } from '@jay-framework/runtime-automation';
 
@@ -17,6 +17,47 @@ interface CompositePart {
 
 declare function makeCompositeJayComponent<PropsT extends object, ViewState extends object, Refs extends object, JayElementT extends JayElement<ViewState, Refs>, CompCore extends JayComponentCore<PropsT, ViewState>>(preRender: PreRenderElement<ViewState, Refs, JayElementT>, defaultViewState: ViewState, fastCarryForward: object, parts: Array<CompositePart>, trackByMap?: TrackByMap): (props: PropsT) => _jay_framework_component.ConcreteJayComponent<PropsT, ViewState, Refs, CompCore, JayElementT>;
 
+/**
+ * Client-side context and helpers for headless component instances.
+ *
+ * Provides the mechanism to deliver server-produced fast ViewState and carryForward
+ * to headless component instances on the client.
+ *
+ * Flow:
+ * 1. makeCompositeJayComponent extracts __headlessInstances from ViewState/carryForward
+ * 2. Registers HEADLESS_INSTANCES context during component construction
+ * 3. makeHeadlessInstanceComponent creates instance components that resolve their data
+ *    from this context by coordinate key
+ */
+
+/**
+ * Data structure for headless instance ViewStates and carryForwards.
+ * Keyed by coordinate path (e.g., "product-card:0", "p1/product-card:0").
+ */
+interface HeadlessInstancesData {
+    viewStates: Record<string, object>;
+    carryForwards: Record<string, object>;
+}
+/**
+ * Context marker for headless instance data.
+ * Provided by makeCompositeJayComponent, consumed by makeHeadlessInstanceComponent.
+ */
+declare const HEADLESS_INSTANCES: ContextMarker<HeadlessInstancesData>;
+/**
+ * Create a headless instance component that receives its fast ViewState from the
+ * HEADLESS_INSTANCES context, matched by coordinate key.
+ *
+ * This replaces makeJayComponent for headless instances. It wraps the plugin's
+ * interactive constructor to inject the instance's fast ViewState signals and
+ * carryForward before any plugin-defined context markers.
+ *
+ * @param preRender - The inline template's render function
+ * @param interactiveConstructor - The plugin's interactive constructor
+ * @param coordinateKey - The coordinate key for this instance (e.g., "product-card:0")
+ * @param pluginContexts - Additional context markers from the plugin (if any)
+ */
+declare function makeHeadlessInstanceComponent<PropsT extends object, ViewState extends object, Refs extends object, JayElementT extends JayElement<ViewState, Refs>, CompCore extends JayComponentCore<PropsT, ViewState>>(preRender: PreRenderElement<ViewState, Refs, JayElementT>, interactiveConstructor: ComponentConstructor<PropsT, Refs, ViewState, any, CompCore>, coordinateKey: string, pluginContexts?: ContextMarkers<any>): any;
+
 /**
  * Client-side action caller for Jay Stack.
  *
@@ -82,4 +123,4 @@ declare function setActionCallerOptions(options: ActionCallerOptions): void;
  */
 declare function createActionCaller<Input, Output>(actionName: string, method?: HttpMethod): (input: Input) => Promise<Output>;
 
-export { type ActionCallerOptions, ActionError, type CompositePart, type HttpMethod, createActionCaller, makeCompositeJayComponent, setActionCallerOptions };
+export { type ActionCallerOptions, ActionError, type CompositePart, HEADLESS_INSTANCES, type HeadlessInstancesData, type HttpMethod, createActionCaller, makeCompositeJayComponent, makeHeadlessInstanceComponent, setActionCallerOptions };

package/dist/index.js

@@ -4,8 +4,8 @@ var __publicField = (obj, key, value) => {
   __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
-import { makeJayComponent, materializeViewState, createSignal } from "@jay-framework/component";
-import { createJayContext } from "@jay-framework/runtime";
+import { makeJayComponent, createSignal, COMPONENT_CONTEXT, materializeViewState } from "@jay-framework/component";
+import { createJayContext, useContext } from "@jay-framework/runtime";
 function deepMergeViewStates$1(base, overlay, trackByMap, path = "") {
   if (!base && !overlay)
     return {};
@@ -77,6 +77,23 @@ function mergeArraysByTrackBy$1(baseArray, overlayArray, trackByField, trackByMa
     }
   });
 }
+const HEADLESS_INSTANCES = createJayContext();
+function makeSignals$1(obj) {
+  return Object.keys(obj).reduce((signals, key) => {
+    signals[key] = createSignal(obj[key]);
+    return signals;
+  }, {});
+}
+function makeHeadlessInstanceComponent(preRender, interactiveConstructor, coordinateKey, pluginContexts = []) {
+  const wrappedConstructor = (props, refs, ...pluginResolvedContexts) => {
+    const instanceData = useContext(HEADLESS_INSTANCES);
+    const fastVS = instanceData?.viewStates?.[coordinateKey];
+    const cf = instanceData?.carryForwards?.[coordinateKey] || {};
+    const signalVS = fastVS ? makeSignals$1(fastVS) : void 0;
+    return interactiveConstructor(props, refs, signalVS, cf, ...pluginResolvedContexts);
+  };
+  return makeJayComponent(preRender, wrappedConstructor, ...pluginContexts);
+}
 function makeSignals(obj) {
   return Object.keys(obj).reduce((signals, key) => {
     signals[key] = createSignal(obj[key]);
@@ -86,7 +103,21 @@ function makeSignals(obj) {
 function makeCompositeJayComponent(preRender, defaultViewState, fastCarryForward, parts, trackByMap = {}) {
   const interactiveParts = parts.filter((part) => part.comp !== void 0);
   const hasFastRendering = defaultViewState !== null && defaultViewState !== void 0;
+  const headlessInstanceViewStates = defaultViewState?.__headlessInstances;
+  const headlessInstanceCarryForwards = fastCarryForward?.__headlessInstances;
+  if (headlessInstanceViewStates)
+    delete defaultViewState.__headlessInstances;
+  if (headlessInstanceCarryForwards)
+    delete fastCarryForward.__headlessInstances;
   const comp = (props, refs, ...contexts) => {
+    if (headlessInstanceViewStates || headlessInstanceCarryForwards) {
+      const componentContext = useContext(COMPONENT_CONTEXT);
+      const instancesData = {
+        viewStates: headlessInstanceViewStates || {},
+        carryForwards: headlessInstanceCarryForwards || {}
+      };
+      componentContext.provideContexts.push([HEADLESS_INSTANCES, instancesData]);
+    }
     const instances = interactiveParts.map(
       (part) => {
         const partRefs = part.key ? refs[part.key] : refs;
@@ -486,8 +517,10 @@ const AUTOMATION_CONTEXT = createJayContext();
 export {
   AUTOMATION_CONTEXT,
   ActionError,
+  HEADLESS_INSTANCES,
   createActionCaller,
   makeCompositeJayComponent,
+  makeHeadlessInstanceComponent,
   setActionCallerOptions,
   wrapWithAutomation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/stack-client-runtime",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -27,15 +27,15 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.11.0",
-    "@jay-framework/fullstack-component": "^0.11.0",
-    "@jay-framework/runtime": "^0.11.0",
-    "@jay-framework/runtime-automation": "^0.11.0",
-    "@jay-framework/view-state-merge": "^0.11.0"
+    "@jay-framework/component": "^0.12.0",
+    "@jay-framework/fullstack-component": "^0.12.0",
+    "@jay-framework/runtime": "^0.12.0",
+    "@jay-framework/runtime-automation": "^0.12.0",
+    "@jay-framework/view-state-merge": "^0.12.0"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.11.0",
-    "@jay-framework/jay-cli": "^0.11.0",
+    "@jay-framework/dev-environment": "^0.12.0",
+    "@jay-framework/jay-cli": "^0.12.0",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",