octane 0.2.11 → 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

@@ -1,3 +1,4 @@
+export { trustHTML, type TrustedHTML } from './trusted-html.js';
 export { version } from './version.js';
 export type * from './public-types.js';
 export { StrictMode, unstable_batchedUpdates } from './compatibility.js';
@@ -8,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

@@ -1,3 +1,4 @@
+import { trustHTML } from "./trusted-html.js";
 import { version } from "./version.js";
 import { StrictMode, unstable_batchedUpdates } from "./compatibility.js";
 import { initializeHydrationEventCapture } from "./hydration/event-capture.js";
@@ -220,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,
@@ -231,6 +234,7 @@ export {
   HMR,
   HYDRATION_RANGE_BOUNDARY,
   Hydrate,
+  ServerCallUncertainError,
   StrictMode,
   Suspense,
   TsrxErrorBoundary,
@@ -267,6 +271,7 @@ export {
   bag8,
   bag9,
   bagOf,
+  batchServerCalls,
   bindRendererRegionOwner,
   child,
   childSlot,
@@ -410,6 +415,7 @@ export {
   template,
   textHole,
   textSlot,
+  trustHTML,
   tryBlock,
   Activity2 as unstable_Activity,
   ViewTransition2 as unstable_ViewTransition,

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-strong.d.ts

@@ -0,0 +1,33 @@
+/** Strong mode's DOM JSX contract; component props keep their authored types. */
+import type { JSX as CompatibilityJSX } from './jsx-runtime.js';
+import type { TrustedHTML } from './trusted-html.js';
+
+export { Fragment, jsx, jsxs, jsxDEV } from './jsx-runtime.js';
+export type {
+	ClassValue,
+	CSSProperties,
+	SignalCSSProperties,
+	OctaneElement,
+} from './jsx-runtime.js';
+
+type StrongIntrinsicProps<P> = Omit<
+	P,
+	'dangerouslySetInnerHTML' | 'suppressHydrationWarning' | 'suppressNativeChangeWarning'
+> & {
+	dangerouslySetInnerHTML?: TrustedHTML | null | undefined;
+	suppressHydrationWarning?: never;
+	suppressNativeChangeWarning?: never;
+};
+
+export namespace JSX {
+	export type Element = CompatibilityJSX.Element;
+	export type ElementType = CompatibilityJSX.ElementType;
+	export type ElementChildrenAttribute = CompatibilityJSX.ElementChildrenAttribute;
+	export type IntrinsicAttributes = CompatibilityJSX.IntrinsicAttributes;
+	export type IntrinsicClassAttributes<T> = CompatibilityJSX.IntrinsicClassAttributes<T>;
+	export type IntrinsicElements = {
+		[K in keyof CompatibilityJSX.IntrinsicElements]: StrongIntrinsicProps<
+			CompatibilityJSX.IntrinsicElements[K]
+		>;
+	};
+}

package/dist/jsx-runtime.d.ts

@@ -41,7 +41,9 @@
  * `.tsx` sources) can type-check JSX against octane's real contract.
  */
 import type * as React from 'react';
+import type * as CSS from 'csstype';
 import type { ElementDescriptor, FragmentInstance } from './index.js';
+import type { SignalHandle } from './signals/types.js';
 
 /**
  * Octane's element type — the analog of React's `ReactElement`, and what a
@@ -53,10 +55,21 @@ import type { ElementDescriptor, FragmentInstance } from './index.js';
  */
 export interface OctaneElement<P = any> extends ElementDescriptor<P> {}
 
-export interface CSSProperties extends React.CSSProperties {
+/** Inline styles use Octane's numeric length coercion for both property spellings. */
+export interface CSSProperties extends React.CSSProperties, CSS.PropertiesHyphen<string | number> {
 	cssFloat?: React.CSSProperties['float'];
+	/** Element-scoped View Transition isolation, including authored `!important` values. */
+	viewTransitionScope?: 'none' | 'all' | (string & {});
 }
 
+/** Native DOM style values; plain CSSProperties remains usable by CSS-consuming libraries. */
+export type SignalCSSProperties = {
+	[K in keyof CSSProperties]: CSSProperties[K] | SignalHandle<CSSProperties[K] | null>;
+} & {
+	[customProperty: `--${string}`]:
+		string | number | SignalHandle<string | number | null | undefined> | undefined;
+};
+
 export type ClassValue =
 	| string
 	| number
@@ -132,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> & {
@@ -143,6 +169,28 @@ type Transformed<P, T> = Omit<P, ReactSyntheticProps | 'className' | 'style' | '
 		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;
 
@@ -599,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 } 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> & {