octane 0.2.12 → 0.2.13

package/dist/independent-hydration-protocol.js

@@ -0,0 +1,80 @@
+import { decodeSignalValue, encodeSignalValue } from "./data-encoding.js";
+function plainRecord(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  if (prototype !== Object.prototype && prototype !== null) return false;
+  return Reflect.ownKeys(value).every((key2) => {
+    if (typeof key2 !== "string") return false;
+    const descriptor = Object.getOwnPropertyDescriptor(value, key2);
+    return descriptor.enumerable && "value" in descriptor;
+  });
+}
+function key(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= 1024;
+}
+function uniqueKeys(value) {
+  return Array.isArray(value) && value.every(key) && new Set(value).size === value.length;
+}
+function captures(value, count) {
+  if (!Array.isArray(value) || value.length !== count) return false;
+  try {
+    for (const capture of value) decodeSignalValue(capture);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isIndependentHydrateManifest(value) {
+  if (!plainRecord(value)) return false;
+  const allowed = /* @__PURE__ */ new Set([
+    "version",
+    "buildId",
+    "boundaryId",
+    "moduleId",
+    "exportName",
+    "captureSchema",
+    "captures",
+    "hookSeed",
+    "idSeed",
+    "signalSites",
+    "styles",
+    "parentDependencies"
+  ]);
+  if (!Object.keys(value).every((name) => allowed.has(name))) return false;
+  if (value.version !== 1 || !key(value.buildId) || !key(value.boundaryId) || !key(value.moduleId) || !key(value.exportName) || !Number.isSafeInteger(value.hookSeed) || value.hookSeed < 0 || !Number.isSafeInteger(value.idSeed) || value.idSeed < 0 || value.parentDependencies !== false || !uniqueKeys(value.signalSites) || !uniqueKeys(value.styles) || !Array.isArray(value.captureSchema)) {
+    return false;
+  }
+  const names = /* @__PURE__ */ new Set();
+  for (const capture of value.captureSchema) {
+    if (!plainRecord(capture) || Object.keys(capture).length !== 2 || !key(capture.name) || capture.type !== "json" || names.has(capture.name)) {
+      return false;
+    }
+    names.add(capture.name);
+  }
+  return captures(value.captures, value.captureSchema.length);
+}
+function createIndependentHydrateManifest(template, values, instanceBoundaryId, buildId, build) {
+  const manifest = {
+    ...template,
+    buildId,
+    boundaryId: instanceBoundaryId,
+    moduleId: build.moduleId,
+    captures: values.map((value) => encodeSignalValue(value)),
+    styles: build.styles
+  };
+  if (!isIndependentHydrateManifest(manifest)) {
+    throw new TypeError("Invalid independent Hydrate manifest inputs.");
+  }
+  return Object.freeze(manifest);
+}
+function serializeIndependentHydrateManifest(manifest) {
+  if (!isIndependentHydrateManifest(manifest)) {
+    throw new TypeError("Invalid independent Hydrate manifest.");
+  }
+  return JSON.stringify(manifest).replace(/&/g, "\\u0026").replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+export {
+  createIndependentHydrateManifest,
+  isIndependentHydrateManifest,
+  serializeIndependentHydrateManifest
+};

package/dist/index.d.ts

@@ -9,4 +9,6 @@ export { createSubSlot, subSlot, type SubSlot, type SlotlessSubSlot, type SubSlo
 export { createRoot, hydrateRoot, flushSync, act, isInActScope, type Root, type RootContainer, type RootOptions, useState, useLinkedState, type LinkedStatePrevious, type LinkedStateOptions, useReducer, useEffect, useLayoutEffect, useInsertionEffect, useMemo, useCallback, useRef, useId, useImperativeHandle, useEffectEvent, useSyncExternalStore, useDeferredValue, useTransition, useActionState, useActionState as useFormState, useFormStatus, useOptimistic, useDebugValue, type FormStatus, startTransition, requestFormReset, memo, lazy, preload, preinit, preloadModule, preinitModule, preconnect, prefetchDNS, createContext, use, useContext, type Context, type ForeignHostContext, Suspense, ErrorBoundary, Hydrate, Activity, Activity as unstable_Activity, ViewTransition, addTransitionType, ViewTransition as unstable_ViewTransition, addTransitionType as unstable_addTransitionType, ViewTransitionPseudoElement, type ViewTransitionProps, type ViewTransitionInstance, Fragment, createPortal, type PortalDescriptor, createElement, cloneElement, isValidElement, isChildrenBlock, descriptorChildren, Children, type ElementDescriptor, type ComponentBody, type OctaneNode, TsrxErrorBoundary, __useStateWithGetter, __useLinkedStateWithGetter, __useReducerWithGetter, __createVoidRoot, bindRendererRegionOwner, EXTERNAL_HYDRATION_PROMISE, HYDRATION_RANGE_BOUNDARY, createHostContextRequest, __vtSeen, template, clone, drainFrag, bag0, bag1, bag2, bag3, bag4, bag5, bag6, bag7, bag8, bag9, bag10, bag11, bag12, bag13, bag14, bag15, bag16, bagOf, evt0, evt0u, evt1, evt1u, evt2, evt2u, evt1e, evt2e, evtN, evtNu, setEventHandler, devEventListener, devHtmlNesting, htext, htextSwap, child, sibling, setText, setScriptText, setHTML, setDangerouslySetInnerHTML, setDangerouslySetInnerHTMLSources, markDangerouslySetInnerHTMLChildren, setAttribute, setStringData, setBooleanAttribute, setAriaAttribute, setClassName, setClassAttr, normalizeClass, isHydratingStyle, setStyle, setStyleProperty, setStyleProperties, setSpread, snapshotSpread, setHostPropSources, queueNativeChangeDiagnostic, queueFormAuthoringDiagnostic, markNativeChangeDiagnosticStatic, setFormAction, setValue, setFormControlSources, setChecked, setCheckedCheckable, setSelectValue, setDefaultValue, setDefaultValueUncontrolled, setDefaultChecked, setAutoFocus, attachRef, queueRefAttach, queueRefDetach, replaceRef, queueOwnRefDetach, injectStyle, headBlock, stylesheetResource, styleResource, scriptResource, namespaceHead, namespaceHeadElement, delegateEvents, delegateCaptureEvents, fastForBlock, fastKeyedForBlock, fastMapSlot, forBlock, keyedForBlock, mapSlot, ifBlock, errorBlock, tryBlock, switchBlock, activityBlock, componentSlot, componentSlotVoid, componentSlotLite, compilerCacheArray, compilerCacheImmutableArrayFilter, compilerCacheMappedArray, compilerCacheContext, compilerOwnsContextProvider, markSingleRoot, markWarm, markSingleRoot as __s, markChildrenBlock, createScopedValue, createScopedElement, childSlot, positionalChildren, textSlot, textHole, childTextHole, hostComponent, renderBlock, portal, hookSlots, withSlot, manualHook, invokeManualHook, useBatch, registerWarmPlan, seedOrCreate, warmMemo, warmChild, puMiss, puTake0, puTake1, puTake2, puTake3, puTake4, puPub, provideContext, mountFragmentRef, FragmentInstance, hmr, HMR, hasPendingWork, type Scope, type Block, drainPassiveEffects, setIsOctaneActEnvironment, resetFloatResourceState, setTransitionFallbackTimeout, getTransitionFallbackTimeout, } from './runtime.js';
 export type { HydrateOptions, HydrateProps, HydrateWhen, HydrationInteractionEvent, HydrationInteractionEvents, HydrationPrefetchContext, HydrationPrefetchFunction, HydrationPrefetchStrategy, HydrationPrefetchWaitReason, HydrationStrategy, HydrationWhen, } from './hydration/types.js';
 export { __serverRpc } from './server-rpc-client.js';
+export { ServerCallUncertainError } from './server-rpc-protocol.js';
+export { batchServerCalls, type ServerCallBatchOptions } from './server-rpc-batch-client.js';
 export { __methodDep } from './method-dep.js';

package/dist/index.js

@@ -221,6 +221,8 @@ import {
   getTransitionFallbackTimeout
 } from "./runtime.js";
 import { __serverRpc } from "./server-rpc-client.js";
+import { ServerCallUncertainError } from "./server-rpc-protocol.js";
+import { batchServerCalls } from "./server-rpc-batch-client.js";
 import { __methodDep } from "./method-dep.js";
 export {
   Activity,
@@ -232,6 +234,7 @@ export {
   HMR,
   HYDRATION_RANGE_BOUNDARY,
   Hydrate,
+  ServerCallUncertainError,
   StrictMode,
   Suspense,
   TsrxErrorBoundary,
@@ -268,6 +271,7 @@ export {
   bag8,
   bag9,
   bagOf,
+  batchServerCalls,
   bindRendererRegionOwner,
   child,
   childSlot,

package/dist/internal/signal-read.d.ts

@@ -0,0 +1 @@
+export { readNativeDomValue } from '../signals/read-protocol.js';

package/dist/internal/signal-read.js

@@ -0,0 +1,4 @@
+import { readNativeDomValue } from "../signals/read-protocol.js";
+export {
+  readNativeDomValue
+};

package/dist/jsx-runtime.d.ts

@@ -145,6 +145,19 @@ type ExistingButtonAttribute<
 	Fallback,
 > = K extends keyof React.ButtonHTMLAttributes<T> ? React.ButtonHTMLAttributes<T>[K] : Fallback;
 
+/** Uncontrolled initialization and framework instructions are not live bindings. */
+type UnboundProps =
+	| 'defaultValue'
+	| 'defaultChecked'
+	| 'dangerouslySetInnerHTML'
+	| 'suppressContentEditableWarning'
+	| 'suppressHydrationWarning'
+	| 'suppressNativeChangeWarning'
+	| '__octaneNativeChangeDiagnostic'
+	| 'ref'
+	| 'key'
+	| 'children';
+
 /** Octane's attribute transform over one React attribute interface. */
 type Transformed<P, T> = Omit<P, ReactSyntheticProps | 'className' | 'style' | 'children'> &
 	NativeEventHandlers<P, T & EventTarget> & {
@@ -152,14 +165,32 @@ type Transformed<P, T> = Omit<P, ReactSyntheticProps | 'className' | 'style' | '
 		className?: ClassValue;
 		for?: string;
 		xmlns?: string;
-		style?:
-			| string
-			| CSSProperties
-			| SignalCSSProperties
-			| SignalHandle<string | CSSProperties | SignalCSSProperties | null | undefined>;
+		style?: string | CSSProperties;
 		children?: unknown;
 	};
 
+type BoundStyle<S> = S | SignalCSSProperties | null | SignalHandle<S | SignalCSSProperties | null>;
+
+/** Provider-owned compiler attributes. Augment without widening component props or signal types. */
+export interface NativeAttributeExtensions {}
+
+/**
+ * Only a host JSX site installs direct bindings. Keep reusable attribute and
+ * component-prop types scalar: their consumers may read values imperatively.
+ * A component can explicitly opt in with SignalHandle or this JSX namespace.
+ */
+type BoundIntrinsicProps<P> = {
+	[K in keyof P]: K extends UnboundProps | ReactSyntheticProps
+		? P[K]
+		: K extends 'style'
+			? BoundStyle<P[K]>
+			: P[K] | SignalHandle<P[K]>;
+} & NativeAttributeExtensions;
+
+type BoundIntrinsicElements = {
+	[K in keyof Octane.JSX.IntrinsicElements]: BoundIntrinsicProps<Octane.JSX.IntrinsicElements[K]>;
+};
+
 declare namespace Octane {
 	type Key = string | number | bigint;
 
@@ -616,7 +647,15 @@ declare namespace Octane {
 	}
 }
 
-export import JSX = Octane.JSX;
+/** Automatic JSX runtime types include the host's direct signal bindings. */
+export namespace JSX {
+	type ElementType = Octane.JSX.ElementType;
+	interface Element extends Octane.JSX.Element {}
+	interface ElementChildrenAttribute extends Octane.JSX.ElementChildrenAttribute {}
+	interface IntrinsicAttributes extends Octane.JSX.IntrinsicAttributes {}
+	interface IntrinsicClassAttributes<T> extends Octane.JSX.IntrinsicClassAttributes<T> {}
+	interface IntrinsicElements extends BoundIntrinsicElements {}
+}
 export { Octane };
 
 // The automatic-runtime entry points, for type resolution only — octane's

package/dist/public-types.d.ts

@@ -2,7 +2,21 @@
 import type * as React from 'react';
 import type { Octane } from './jsx-runtime.js';
 import type { Activity, Context, ElementDescriptor, OctaneNode, PortalDescriptor, Suspense } from './runtime.js';
-export type { JSX, Octane, OctaneElement, ClassValue, CSSProperties, SignalCSSProperties, } from './jsx-runtime.js';
+export type { Octane, OctaneElement, ClassValue, CSSProperties, SignalCSSProperties, } from './jsx-runtime.js';
+/** Reusable component props remain scalar; the automatic JSX runtime adds bindings. */
+export declare namespace JSX {
+    type ElementType = Octane.JSX.ElementType;
+    interface Element extends Octane.JSX.Element {
+    }
+    interface ElementChildrenAttribute extends Octane.JSX.ElementChildrenAttribute {
+    }
+    interface IntrinsicAttributes extends Octane.JSX.IntrinsicAttributes {
+    }
+    interface IntrinsicClassAttributes<T> extends Octane.JSX.IntrinsicClassAttributes<T> {
+    }
+    interface IntrinsicElements extends Octane.JSX.IntrinsicElements {
+    }
+}
 /** Migration alias. New Octane code should use OctaneNode. */
 export type ReactNode = OctaneNode;
 export type ReactElement<P = any, T extends ElementDescriptor<P>['type'] = ElementDescriptor<P>['type']> = ElementDescriptor<P> & {