@fictjs/runtime 0.9.0 → 0.11.0

package/dist/{signal-C4ISF17w.d.cts → signal-Z4KkDk9h.d.cts}

@@ -19,6 +19,17 @@ interface MemoOptions<T> {
     name?: string;
     /** Source location */
     devToolsSource?: string;
+    /** Internal memo created by compiler runtime plumbing (hidden from DevTools) */
+    internal?: boolean;
+}
+/**
+ * Options for creating an effect
+ */
+interface EffectOptions {
+    /** Debug name */
+    name?: string;
+    /** Source location */
+    devToolsSource?: string;
 }
 /**
  * Signal accessor - function to get/set signal value
@@ -63,4 +74,4 @@ declare function __resetReactiveState(): void;
  */
 declare function createSelector<T>(source: () => T, equalityFn?: (a: T, b: T) => boolean): (key: T) => boolean;
 
-export { type ComputedAccessor as C, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };
+export { type ComputedAccessor as C, type EffectOptions as E, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };

package/dist/{signal-C4ISF17w.d.ts → signal-Z4KkDk9h.d.ts}

@@ -19,6 +19,17 @@ interface MemoOptions<T> {
     name?: string;
     /** Source location */
     devToolsSource?: string;
+    /** Internal memo created by compiler runtime plumbing (hidden from DevTools) */
+    internal?: boolean;
+}
+/**
+ * Options for creating an effect
+ */
+interface EffectOptions {
+    /** Debug name */
+    name?: string;
+    /** Source location */
+    devToolsSource?: string;
 }
 /**
  * Signal accessor - function to get/set signal value
@@ -63,4 +74,4 @@ declare function __resetReactiveState(): void;
  */
 declare function createSelector<T>(source: () => T, equalityFn?: (a: T, b: T) => boolean): (key: T) => boolean;
 
-export { type ComputedAccessor as C, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };
+export { type ComputedAccessor as C, type EffectOptions as E, type MemoOptions as M, type SignalAccessor as S, __resetReactiveState as _, type SignalOptions as a, createSelector as c, effectScope as e, signal as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fictjs/runtime",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Fict reactive runtime",
   "publishConfig": {
     "access": "public",
@@ -70,7 +70,7 @@
   "author": "unadlib",
   "license": "MIT",
   "scripts": {
-    "build": "tsup",
+    "build": "pnpm run clean && tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:stress": "FICT_RUNTIME_STRESS=1 vitest run test/runtime-stability.stress.test.ts",

package/src/binding.ts

@@ -302,8 +302,17 @@ export function callEventHandler(
  * createTextBinding(() => $count())
  * ```
  */
-export function createTextBinding(value: MaybeReactive<unknown>): Text {
-  const text = document.createTextNode('')
+export function createTextBinding(
+  value: MaybeReactive<unknown>,
+  owner?: Document | Node | null,
+): Text {
+  const textOwnerDocument =
+    owner && 'nodeType' in owner
+      ? owner.nodeType === 9
+        ? (owner as Document)
+        : ((owner as Node).ownerDocument ?? document)
+      : document
+  const text = textOwnerDocument.createTextNode('')
 
   if (isReactive(value)) {
     // Reactive: create effect to update text when value changes
@@ -706,6 +715,7 @@ export function insert(
   createElementFn?: CreateElementFn,
 ): Cleanup {
   const hostRoot = getCurrentRoot()
+  const parentOwnerDocument = parent.ownerDocument ?? document
   let marker: Node
   let ownsMarker = false
   let createFn: CreateElementFn | undefined = createElementFn
@@ -714,11 +724,12 @@ export function insert(
     marker = markerOrCreateElement
     createFn = createElementFn
   } else {
-    marker = document.createComment('fict:insert')
+    marker = parentOwnerDocument.createComment('fict:insert')
     parent.appendChild(marker)
     createFn = markerOrCreateElement as CreateElementFn | undefined
     ownsMarker = true
   }
+  const markerOwnerDocument = marker.ownerDocument ?? parentOwnerDocument
 
   let currentNodes: Node[] = []
   let currentText: Text | null = null
@@ -733,7 +744,7 @@ export function insert(
 
   const setTextNode = (textValue: string, shouldInsert: boolean, parentNode: ParentNode & Node) => {
     if (!currentText) {
-      currentText = document.createTextNode(textValue)
+      currentText = (parentNode.ownerDocument ?? markerOwnerDocument).createTextNode(textValue)
     } else if (currentText.data !== textValue) {
       currentText.data = textValue
     }
@@ -789,6 +800,7 @@ export function insert(
     let handledError = false
     try {
       let newNode: Node | Node[]
+      const ownerDocument = parentNode?.ownerDocument ?? markerOwnerDocument
 
       if (value instanceof Node) {
         newNode = value
@@ -799,18 +811,18 @@ export function insert(
           if (createFn) {
             const mapped: Node[] = []
             for (const item of value) {
-              mapped.push(...toNodeArray(createFn(item as any)))
+              mapped.push(...toNodeArray(createFn(item as any), ownerDocument))
             }
             newNode = mapped
           } else {
-            newNode = document.createTextNode(String(value))
+            newNode = ownerDocument.createTextNode(String(value))
           }
         }
       } else {
-        newNode = createFn ? createFn(value) : document.createTextNode(String(value))
+        newNode = createFn ? createFn(value) : ownerDocument.createTextNode(String(value))
       }
 
-      nodes = toNodeArray(newNode)
+      nodes = toNodeArray(newNode, ownerDocument)
       if (root.suspended) {
         handledError = true
         destroyRoot(root)
@@ -867,6 +879,7 @@ export function insertBetween(
   createElementFn?: CreateElementFn,
 ): Cleanup {
   const hostRoot = getCurrentRoot()
+  const markerOwnerDocument = start.ownerDocument ?? end.ownerDocument ?? document
   let currentNodes: Node[] = []
   let currentText: Text | null = null
   let currentRoot: RootContext | null = null
@@ -890,8 +903,9 @@ export function insertBetween(
   }
 
   const setTextNode = (textValue: string, shouldInsert: boolean) => {
+    const parentNode = start.parentNode as (ParentNode & Node) | null
     if (!currentText) {
-      currentText = document.createTextNode(textValue)
+      currentText = (parentNode?.ownerDocument ?? markerOwnerDocument).createTextNode(textValue)
     } else if (currentText.data !== textValue) {
       currentText.data = textValue
     }
@@ -906,7 +920,6 @@ export function insertBetween(
     }
 
     clearCurrentNodes()
-    const parentNode = start.parentNode as (ParentNode & Node) | null
     if (parentNode) {
       insertNodesBefore(parentNode, [currentText], end)
       currentNodes = [currentText]
@@ -959,6 +972,7 @@ export function insertBetween(
     let handledError = false
     try {
       let newNode: Node | Node[] = undefined as unknown as Node | Node[]
+      const ownerDocument = parentNode?.ownerDocument ?? markerOwnerDocument
       const createValue = () => {
         if (value instanceof Node) {
           return value
@@ -970,24 +984,31 @@ export function insertBetween(
           if (createElementFn) {
             const mapped: Node[] = []
             for (const item of value) {
-              mapped.push(...toNodeArray(createElementFn(item as any)))
+              mapped.push(...toNodeArray(createElementFn(item as any), ownerDocument))
             }
             return mapped
           }
-          return document.createTextNode(String(value))
+          return ownerDocument.createTextNode(String(value))
         }
-        return createElementFn ? createElementFn(value) : document.createTextNode(String(value))
+        return createElementFn
+          ? createElementFn(value)
+          : ownerDocument.createTextNode(String(value))
       }
 
       if (initialHydrating && isHydratingActive() && parentNode) {
-        withHydrationRange(start.nextSibling, end, parentNode.ownerDocument ?? document, () => {
-          newNode = createValue()
-        })
+        withHydrationRange(
+          start.nextSibling,
+          end,
+          parentNode.ownerDocument ?? markerOwnerDocument,
+          () => {
+            newNode = createValue()
+          },
+        )
       } else {
         newNode = createValue()
       }
 
-      nodes = toNodeArray(newNode)
+      nodes = toNodeArray(newNode, ownerDocument)
       if (root.suspended) {
         handledError = true
         destroyRoot(root)
@@ -1048,7 +1069,7 @@ export function createChildBinding(
   getValue: () => FictNode,
   createElementFn: CreateElementFn,
 ): BindingHandle {
-  const marker = document.createComment('fict:child')
+  const marker = (parent.ownerDocument ?? document).createComment('fict:child')
   parent.appendChild(marker)
   const hostRoot = getCurrentRoot()
 
@@ -1066,7 +1087,7 @@ export function createChildBinding(
       }
 
       const output = createElementFn(value)
-      nodes = toNodeArray(output)
+      nodes = toNodeArray(output, marker.ownerDocument ?? parent.ownerDocument ?? document)
       const parentNode = marker.parentNode as (ParentNode & Node) | null
       if (parentNode) {
         insertNodesBefore(parentNode, nodes, marker)
@@ -1244,7 +1265,7 @@ function globalEventHandler(e: Event): void {
   Object.defineProperty(e, 'currentTarget', {
     configurable: true,
     get() {
-      return node || document
+      return node || oriCurrentTarget || asNode(oriTarget)?.ownerDocument || document
     },
   })
 
@@ -1756,14 +1777,21 @@ export function createConditional(
   options?: ConditionalBindingOptions,
 ): BindingHandle {
   const trackBranchReads = options?.trackBranchReads === true
+  const hostRoot = getCurrentRoot()
   const useProvided = !!(startOverride && endOverride)
-  const startMarker = useProvided ? startOverride! : document.createComment('fict:cond:start')
-  const endMarker = useProvided ? endOverride! : document.createComment('fict:cond:end')
-  const fragment = useProvided ? startMarker : document.createDocumentFragment()
+  const markerOwnerDocument =
+    startOverride?.ownerDocument ??
+    endOverride?.ownerDocument ??
+    hostRoot?.ownerDocument ??
+    document
+  const startMarker = useProvided
+    ? startOverride!
+    : markerOwnerDocument.createComment('fict:cond:start')
+  const endMarker = useProvided ? endOverride! : markerOwnerDocument.createComment('fict:cond:end')
+  const fragment = useProvided ? startMarker : markerOwnerDocument.createDocumentFragment()
   if (!useProvided) {
     ;(fragment as DocumentFragment).append(startMarker, endMarker)
   }
-  const hostRoot = getCurrentRoot()
 
   let currentNodes: Node[] = []
   let currentRoot: RootContext | null = null
@@ -1815,7 +1843,7 @@ export function createConditional(
         withHydrationRange(
           startMarker.nextSibling,
           endMarker,
-          parent.ownerDocument ?? document,
+          parent.ownerDocument ?? markerOwnerDocument,
           () => {
             const output = trackBranchReads ? render() : untrack(render)
             if (output == null || output === false) {
@@ -1921,7 +1949,7 @@ export function createConditional(
           return
         }
         const el = createElementFn(scratchOutput)
-        const nodes = toNodeArray(el)
+        const nodes = toNodeArray(el, parent.ownerDocument ?? markerOwnerDocument)
         insertNodesBefore(parent, nodes, endMarker)
         currentNodes = nodes
       } catch (err) {
@@ -1974,7 +2002,7 @@ export function createConditional(
         return
       }
       const el = createElementFn(output)
-      const nodes = toNodeArray(el)
+      const nodes = toNodeArray(el, parent.ownerDocument ?? markerOwnerDocument)
       insertNodesBefore(parent, nodes, endMarker)
       currentNodes = nodes
     } catch (err) {
@@ -2071,7 +2099,8 @@ export function createPortal(
   // This is needed because createRenderEffect will push/pop its own root context
   const parentRoot = getCurrentRoot()
 
-  const marker = document.createComment('fict:portal')
+  const markerOwnerDocument = container.ownerDocument ?? document
+  const marker = markerOwnerDocument.createComment('fict:portal')
   container.appendChild(marker)
 
   let currentNodes: Node[] = []
@@ -2090,13 +2119,14 @@ export function createPortal(
 
     // Create new content
     const root = createRootContext(parentRoot)
+    root.ownerDocument = container.ownerDocument ?? parentRoot?.ownerDocument ?? document
     const prev = pushRoot(root)
     let handledError = false
     try {
       const output = render()
       if (output != null && output !== false) {
         const el = createElementFn(output)
-        const nodes = toNodeArray(el)
+        const nodes = toNodeArray(el, markerOwnerDocument)
         if (marker.parentNode) {
           insertNodesBefore(marker.parentNode as ParentNode & Node, nodes, marker)
         }

package/src/context.ts

@@ -174,8 +174,9 @@ export function createContext<T>(defaultValue: T): Context<T> {
     contextMap.set(id, props.value)
 
     // Create DOM structure
-    const fragment = document.createDocumentFragment()
-    const marker = document.createComment('fict:ctx')
+    const markerOwnerDocument = providerRoot.ownerDocument ?? hostRoot?.ownerDocument ?? document
+    const fragment = markerOwnerDocument.createDocumentFragment()
+    const marker = markerOwnerDocument.createComment('fict:ctx')
     fragment.appendChild(marker)
 
     let cleanup: (() => void) | undefined
@@ -200,7 +201,7 @@ export function createContext<T>(defaultValue: T): Context<T> {
       let nodes: Node[] = []
       try {
         const output = createElement(children)
-        nodes = toNodeArray(output)
+        nodes = toNodeArray(output, markerOwnerDocument)
         const parentNode = marker.parentNode as (ParentNode & Node) | null
         if (parentNode) {
           insertNodesBefore(parentNode, nodes, marker)

package/src/devtools.ts

@@ -5,18 +5,35 @@ export interface FictDevtoolsHook {
     options?: { name?: string; source?: string; ownerId?: number },
   ) => void
   updateSignal: (id: number, value: unknown) => void
+  disposeSignal?: (id: number) => void
   registerComputed: (
     id: number,
     value: unknown,
-    options?: { name?: string; source?: string; ownerId?: number; hasValue?: boolean },
+    options?: {
+      name?: string
+      source?: string
+      ownerId?: number
+      hasValue?: boolean
+      internal?: boolean
+    },
   ) => void
   updateComputed: (id: number, value: unknown) => void
+  disposeComputed?: (id: number) => void
   registerEffect: (id: number, options?: { ownerId?: number; source?: string }) => void
-  effectRun: (id: number) => void
+  effectRun: (id: number, duration?: number) => void
+  effectCleanup?: (id: number) => void
+  disposeEffect?: (id: number) => void
   /** Track a dependency relationship between subscriber and dependency */
   trackDependency?: (subscriberId: number, dependencyId: number) => void
   /** Remove a dependency relationship when unlinked */
   untrackDependency?: (subscriberId: number, dependencyId: number) => void
+  registerRoot?: (id: number, name?: string) => void
+  disposeRoot?: (id: number) => void
+  rootSuspend?: (id: number, suspended: boolean) => void
+  batchStart?: () => void
+  batchEnd?: () => void
+  flushStart?: () => void
+  flushEnd?: () => void
   cycleDetected?: (payload: { reason: string; detail?: Record<string, unknown> }) => void
 
   // Component lifecycle