@fictjs/runtime 0.9.0 → 0.10.0

package/dist/{chunk-PG4QX2I2.cjs.map → chunk-K3DH5SD5.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/chunk-PG4QX2I2.cjs","../src/context.ts"],"names":[],"mappings":"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","file":"/home/runner/work/fict/fict/packages/runtime/dist/chunk-PG4QX2I2.cjs","sourcesContent":[null,"/**\n * @fileoverview Context API for Fict\n *\n * Provides a way to pass data through the component tree without having to pass\n * props down manually at every level. Context is designed for:\n *\n * - SSR isolation (different request = different context values)\n * - Multi-instance support (multiple app roots with different values)\n * - Subtree scoping (override values in specific parts of the tree)\n *\n * ## Design Principles\n *\n * 1. **Reuses existing RootContext hierarchy** - Uses parent chain for value lookup,\n *    consistent with handleError/handleSuspend mechanisms.\n *\n * 2. **Zero extra root creation overhead** - Provider doesn't create new root,\n *    only mounts value on current root.\n *\n * 3. **Auto-aligned with insert/suspense boundaries** - Because they create child\n *    roots that inherit parent, context values propagate correctly.\n *\n * ## Usage\n *\n * ```tsx\n * // Create context with default value\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Provide value to subtree\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <ThemedComponent />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume value\n * function ThemedComponent() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={theme}>...</div>\n * }\n * ```\n *\n * @module\n */\n\nimport { createElement } from './dom'\nimport { createRenderEffect } from './effect'\nimport {\n  createRootContext,\n  destroyRoot,\n  flushOnMount,\n  getCurrentRoot,\n  popRoot,\n  pushRoot,\n  type RootContext,\n} from './lifecycle'\nimport { insertNodesBefore, removeNodes, toNodeArray } from './node-ops'\nimport type { BaseProps, FictNode } from './types'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Context object created by createContext.\n * Contains the Provider component and serves as a key for context lookup.\n */\nexport interface Context<T> {\n  /** Unique identifier for this context */\n  readonly id: symbol\n  /** Default value when no provider is found */\n  readonly defaultValue: T\n  /** Provider component for supplying context values */\n  Provider: ContextProvider<T>\n  /** Display name for debugging */\n  displayName?: string\n}\n\n/**\n * Props for the Context Provider component\n */\nexport interface ProviderProps<T> extends BaseProps {\n  /** The value to provide to the subtree */\n  value: T\n}\n\n/**\n * Provider component type\n */\nexport type ContextProvider<T> = (props: ProviderProps<T>) => FictNode\n\n// ============================================================================\n// Internal Context Storage\n// ============================================================================\n\n/**\n * WeakMap to store context values per RootContext.\n * Using WeakMap ensures proper garbage collection when roots are destroyed.\n */\nconst contextStorage = new WeakMap<RootContext, Map<symbol, unknown>>()\n\n/**\n * Get the context map for a root, creating it if needed\n */\nfunction getContextMap(root: RootContext): Map<symbol, unknown> {\n  let map = contextStorage.get(root)\n  if (!map) {\n    map = new Map()\n    contextStorage.set(root, map)\n  }\n  return map\n}\n\n// ============================================================================\n// Context API\n// ============================================================================\n\n/**\n * Creates a new context with the given default value.\n *\n * Context provides a way to pass values through the component tree without\n * explicit props drilling. It's especially useful for:\n *\n * - Theme data\n * - Locale/i18n settings\n * - Authentication state\n * - Feature flags\n * - Any data that many components at different nesting levels need\n *\n * @param defaultValue - The value to use when no Provider is found above in the tree\n * @returns A context object with a Provider component\n *\n * @example\n * ```tsx\n * // Create a theme context\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Use the provider\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <Content />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume the context\n * function Content() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={`theme-${theme}`}>Hello</div>\n * }\n * ```\n */\nexport function createContext<T>(defaultValue: T): Context<T> {\n  const id = Symbol('fict.context')\n\n  const context: Context<T> = {\n    id,\n    defaultValue,\n    Provider: null as unknown as ContextProvider<T>,\n  }\n\n  // Create the Provider component\n  context.Provider = function Provider(props: ProviderProps<T>): FictNode {\n    const hostRoot = getCurrentRoot()\n\n    // Create a child root for the provider's subtree\n    // This establishes the provider boundary - children will look up from here\n    const providerRoot = createRootContext(hostRoot)\n\n    // Store the context value on this root\n    const contextMap = getContextMap(providerRoot)\n    contextMap.set(id, props.value)\n\n    // Create DOM structure\n    const fragment = document.createDocumentFragment()\n    const marker = document.createComment('fict:ctx')\n    fragment.appendChild(marker)\n\n    let cleanup: (() => void) | undefined\n    let activeNodes: Node[] = []\n\n    const renderChildren = (children: FictNode) => {\n      // Cleanup previous render\n      if (cleanup) {\n        cleanup()\n        cleanup = undefined\n      }\n      if (activeNodes.length) {\n        removeNodes(activeNodes)\n        activeNodes = []\n      }\n\n      if (children == null || children === false) {\n        return\n      }\n\n      const prev = pushRoot(providerRoot)\n      let nodes: Node[] = []\n      try {\n        const output = createElement(children)\n        nodes = toNodeArray(output)\n        const parentNode = marker.parentNode as (ParentNode & Node) | null\n        if (parentNode) {\n          insertNodesBefore(parentNode, nodes, marker)\n        }\n      } finally {\n        popRoot(prev)\n        flushOnMount(providerRoot)\n      }\n\n      cleanup = () => {\n        destroyRoot(providerRoot)\n        removeNodes(nodes)\n      }\n      activeNodes = nodes\n    }\n\n    // Initial render\n    createRenderEffect(() => {\n      // Update context value on re-render (if value prop changes reactively)\n      contextMap.set(id, props.value)\n      renderChildren(props.children)\n    })\n\n    return fragment\n  }\n\n  return context\n}\n\n/**\n * Reads the current value of a context.\n *\n * useContext looks up through the RootContext parent chain to find the\n * nearest Provider for this context. If no Provider is found, returns\n * the context's default value.\n *\n * @param context - The context object created by createContext\n * @returns The current context value\n *\n * @example\n * ```tsx\n * const ThemeContext = createContext('light')\n *\n * function ThemedButton() {\n *   const theme = useContext(ThemeContext)\n *   return <button class={theme === 'dark' ? 'btn-dark' : 'btn-light'}>Click</button>\n * }\n * ```\n */\nexport function useContext<T>(context: Context<T>): T {\n  let root = getCurrentRoot()\n\n  // Walk up the parent chain looking for the context value\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return contextMap.get(context.id) as T\n    }\n    root = root.parent\n  }\n\n  // No provider found, return default value\n  return context.defaultValue\n}\n\n/**\n * Checks if a context value is currently provided in the tree.\n *\n * Useful for conditional behavior when a provider may or may not exist.\n *\n * @param context - The context object to check\n * @returns true if a Provider exists above in the tree\n *\n * @example\n * ```tsx\n * function OptionalTheme() {\n *   if (hasContext(ThemeContext)) {\n *     const theme = useContext(ThemeContext)\n *     return <div class={theme}>Themed content</div>\n *   }\n *   return <div>Default content</div>\n * }\n * ```\n */\nexport function hasContext<T>(context: Context<T>): boolean {\n  let root = getCurrentRoot()\n\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return true\n    }\n    root = root.parent\n  }\n\n  return false\n}\n"]}
+{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/chunk-K3DH5SD5.cjs","../src/context.ts"],"names":[],"mappings":"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","file":"/home/runner/work/fict/fict/packages/runtime/dist/chunk-K3DH5SD5.cjs","sourcesContent":[null,"/**\n * @fileoverview Context API for Fict\n *\n * Provides a way to pass data through the component tree without having to pass\n * props down manually at every level. Context is designed for:\n *\n * - SSR isolation (different request = different context values)\n * - Multi-instance support (multiple app roots with different values)\n * - Subtree scoping (override values in specific parts of the tree)\n *\n * ## Design Principles\n *\n * 1. **Reuses existing RootContext hierarchy** - Uses parent chain for value lookup,\n *    consistent with handleError/handleSuspend mechanisms.\n *\n * 2. **Zero extra root creation overhead** - Provider doesn't create new root,\n *    only mounts value on current root.\n *\n * 3. **Auto-aligned with insert/suspense boundaries** - Because they create child\n *    roots that inherit parent, context values propagate correctly.\n *\n * ## Usage\n *\n * ```tsx\n * // Create context with default value\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Provide value to subtree\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <ThemedComponent />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume value\n * function ThemedComponent() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={theme}>...</div>\n * }\n * ```\n *\n * @module\n */\n\nimport { createElement } from './dom'\nimport { createRenderEffect } from './effect'\nimport {\n  createRootContext,\n  destroyRoot,\n  flushOnMount,\n  getCurrentRoot,\n  popRoot,\n  pushRoot,\n  type RootContext,\n} from './lifecycle'\nimport { insertNodesBefore, removeNodes, toNodeArray } from './node-ops'\nimport type { BaseProps, FictNode } from './types'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Context object created by createContext.\n * Contains the Provider component and serves as a key for context lookup.\n */\nexport interface Context<T> {\n  /** Unique identifier for this context */\n  readonly id: symbol\n  /** Default value when no provider is found */\n  readonly defaultValue: T\n  /** Provider component for supplying context values */\n  Provider: ContextProvider<T>\n  /** Display name for debugging */\n  displayName?: string\n}\n\n/**\n * Props for the Context Provider component\n */\nexport interface ProviderProps<T> extends BaseProps {\n  /** The value to provide to the subtree */\n  value: T\n}\n\n/**\n * Provider component type\n */\nexport type ContextProvider<T> = (props: ProviderProps<T>) => FictNode\n\n// ============================================================================\n// Internal Context Storage\n// ============================================================================\n\n/**\n * WeakMap to store context values per RootContext.\n * Using WeakMap ensures proper garbage collection when roots are destroyed.\n */\nconst contextStorage = new WeakMap<RootContext, Map<symbol, unknown>>()\n\n/**\n * Get the context map for a root, creating it if needed\n */\nfunction getContextMap(root: RootContext): Map<symbol, unknown> {\n  let map = contextStorage.get(root)\n  if (!map) {\n    map = new Map()\n    contextStorage.set(root, map)\n  }\n  return map\n}\n\n// ============================================================================\n// Context API\n// ============================================================================\n\n/**\n * Creates a new context with the given default value.\n *\n * Context provides a way to pass values through the component tree without\n * explicit props drilling. It's especially useful for:\n *\n * - Theme data\n * - Locale/i18n settings\n * - Authentication state\n * - Feature flags\n * - Any data that many components at different nesting levels need\n *\n * @param defaultValue - The value to use when no Provider is found above in the tree\n * @returns A context object with a Provider component\n *\n * @example\n * ```tsx\n * // Create a theme context\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Use the provider\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <Content />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume the context\n * function Content() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={`theme-${theme}`}>Hello</div>\n * }\n * ```\n */\nexport function createContext<T>(defaultValue: T): Context<T> {\n  const id = Symbol('fict.context')\n\n  const context: Context<T> = {\n    id,\n    defaultValue,\n    Provider: null as unknown as ContextProvider<T>,\n  }\n\n  // Create the Provider component\n  context.Provider = function Provider(props: ProviderProps<T>): FictNode {\n    const hostRoot = getCurrentRoot()\n\n    // Create a child root for the provider's subtree\n    // This establishes the provider boundary - children will look up from here\n    const providerRoot = createRootContext(hostRoot)\n\n    // Store the context value on this root\n    const contextMap = getContextMap(providerRoot)\n    contextMap.set(id, props.value)\n\n    // Create DOM structure\n    const fragment = document.createDocumentFragment()\n    const marker = document.createComment('fict:ctx')\n    fragment.appendChild(marker)\n\n    let cleanup: (() => void) | undefined\n    let activeNodes: Node[] = []\n\n    const renderChildren = (children: FictNode) => {\n      // Cleanup previous render\n      if (cleanup) {\n        cleanup()\n        cleanup = undefined\n      }\n      if (activeNodes.length) {\n        removeNodes(activeNodes)\n        activeNodes = []\n      }\n\n      if (children == null || children === false) {\n        return\n      }\n\n      const prev = pushRoot(providerRoot)\n      let nodes: Node[] = []\n      try {\n        const output = createElement(children)\n        nodes = toNodeArray(output)\n        const parentNode = marker.parentNode as (ParentNode & Node) | null\n        if (parentNode) {\n          insertNodesBefore(parentNode, nodes, marker)\n        }\n      } finally {\n        popRoot(prev)\n        flushOnMount(providerRoot)\n      }\n\n      cleanup = () => {\n        destroyRoot(providerRoot)\n        removeNodes(nodes)\n      }\n      activeNodes = nodes\n    }\n\n    // Initial render\n    createRenderEffect(() => {\n      // Update context value on re-render (if value prop changes reactively)\n      contextMap.set(id, props.value)\n      renderChildren(props.children)\n    })\n\n    return fragment\n  }\n\n  return context\n}\n\n/**\n * Reads the current value of a context.\n *\n * useContext looks up through the RootContext parent chain to find the\n * nearest Provider for this context. If no Provider is found, returns\n * the context's default value.\n *\n * @param context - The context object created by createContext\n * @returns The current context value\n *\n * @example\n * ```tsx\n * const ThemeContext = createContext('light')\n *\n * function ThemedButton() {\n *   const theme = useContext(ThemeContext)\n *   return <button class={theme === 'dark' ? 'btn-dark' : 'btn-light'}>Click</button>\n * }\n * ```\n */\nexport function useContext<T>(context: Context<T>): T {\n  let root = getCurrentRoot()\n\n  // Walk up the parent chain looking for the context value\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return contextMap.get(context.id) as T\n    }\n    root = root.parent\n  }\n\n  // No provider found, return default value\n  return context.defaultValue\n}\n\n/**\n * Checks if a context value is currently provided in the tree.\n *\n * Useful for conditional behavior when a provider may or may not exist.\n *\n * @param context - The context object to check\n * @returns true if a Provider exists above in the tree\n *\n * @example\n * ```tsx\n * function OptionalTheme() {\n *   if (hasContext(ThemeContext)) {\n *     const theme = useContext(ThemeContext)\n *     return <div class={theme}>Themed content</div>\n *   }\n *   return <div>Default content</div>\n * }\n * ```\n */\nexport function hasContext<T>(context: Context<T>): boolean {\n  let root = getCurrentRoot()\n\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return true\n    }\n    root = root.parent\n  }\n\n  return false\n}\n"]}

package/dist/{chunk-N6ODUM2Y.js → chunk-P4TZLFV6.js}

@@ -6,7 +6,7 @@ import {
   removeNodes,
   toNodeArray,
   withHydrationRange
-} from "./chunk-T2LNV5Q5.js";
+} from "./chunk-R6FINS25.js";
 import {
   __fictIsHydrating,
   __fictIsSSR,
@@ -21,7 +21,7 @@ import {
   pushRoot,
   setActiveSub,
   signal
-} from "./chunk-DXG3TARY.js";
+} from "./chunk-F4RVNXOL.js";
 
 // src/reconcile.ts
 function reconcileArrays(parentNode, a, b) {
@@ -765,4 +765,4 @@ export {
   isNodeBetweenMarkers,
   createKeyedList
 };
-//# sourceMappingURL=chunk-N6ODUM2Y.js.map
+//# sourceMappingURL=chunk-P4TZLFV6.js.map

package/dist/{chunk-T2LNV5Q5.js → chunk-R6FINS25.js}

@@ -40,7 +40,7 @@ import {
   setTransitionContext,
   signal,
   untrack
-} from "./chunk-DXG3TARY.js";
+} from "./chunk-F4RVNXOL.js";
 
 // src/transition.ts
 function startTransition(fn) {
@@ -86,7 +86,11 @@ function useTransition() {
       throw thrown;
     }
     if (result && typeof result.then === "function") {
-      Promise.resolve(result).finally(() => {
+      void Promise.resolve(result).catch((error) => {
+        if (typeof console !== "undefined" && typeof console.error === "function") {
+          console.error("[fict/transition] Async transition failed.", error);
+        }
+      }).finally(() => {
         endPending();
       });
       return;
@@ -1996,6 +2000,32 @@ var SVG_NS = "http://www.w3.org/2000/svg";
 var MATHML_NS = "http://www.w3.org/1998/Math/MathML";
 var isDev2 = typeof __DEV__ !== "undefined" ? __DEV__ : typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
 var nextComponentId = 1;
+function collectComponentMountElements(node) {
+  if (node instanceof DocumentFragment) {
+    return Array.from(node.childNodes).filter(
+      (child) => child instanceof HTMLElement
+    );
+  }
+  if (node instanceof HTMLElement) {
+    if (node.hasAttribute("data-fict-host")) {
+      const children = Array.from(node.children).filter(
+        (child) => child instanceof HTMLElement
+      );
+      if (children.length > 0) return children;
+    }
+    return [node];
+  }
+  return [];
+}
+function annotateComponentElements(elements, componentId, componentName) {
+  for (const element of elements) {
+    element.setAttribute("data-fict-component", componentName);
+    element.setAttribute("data-fict-component-id", String(componentId));
+    const annotated = element;
+    annotated.__fict_component_id__ = componentId;
+    annotated.__fict_component_name__ = componentName;
+  }
+}
 function render(view, container) {
   const root = createRootContext();
   const prev = pushRoot(root);
@@ -2126,10 +2156,11 @@ function createElementWithContext(node, namespace) {
     });
     const props = createPropsProxy(baseProps);
     const hook = isDev2 ? getDevtoolsHook() : void 0;
+    const componentName = vnode.type.name || "Anonymous";
     const parentId = hook ? __fictGetCurrentComponentId() : void 0;
     const componentId = hook ? nextComponentId++ : void 0;
     if (hook?.registerComponent && componentId !== void 0) {
-      hook.registerComponent(componentId, vnode.type.name || "Anonymous", parentId);
+      hook.registerComponent(componentId, componentName, parentId);
     }
     const ctx = __fictPushContext();
     if (componentId !== void 0) {
@@ -2140,9 +2171,13 @@ function createElementWithContext(node, namespace) {
     }
     try {
       const rendered = vnode.type(props);
+      let mountElements;
+      if (hook && componentId !== void 0) {
+        hook.componentRender?.(componentId);
+      }
       if (hook && componentId !== void 0) {
         onMount(() => {
-          hook.componentMount?.(componentId);
+          hook.componentMount?.(componentId, mountElements);
         });
         onCleanup(() => hook.componentUnmount?.(componentId));
       }
@@ -2165,9 +2200,18 @@ function createElementWithContext(node, namespace) {
         } else {
           host.appendChild(content);
         }
+        if (hook && componentId !== void 0) {
+          mountElements = collectComponentMountElements(host);
+          annotateComponentElements(mountElements, componentId, componentName);
+        }
         return host;
       }
-      return createElementWithContext(rendered, namespace);
+      const componentRoot = createElementWithContext(rendered, namespace);
+      if (hook && componentId !== void 0) {
+        mountElements = collectComponentMountElements(componentRoot);
+        annotateComponentElements(mountElements, componentId, componentName);
+      }
+      return componentRoot;
     } catch (err) {
       if (handleSuspend(err)) {
         return document.createComment("fict:suspend");
@@ -2584,4 +2628,4 @@ export {
   createElement,
   template
 };
-//# sourceMappingURL=chunk-T2LNV5Q5.js.map
+//# sourceMappingURL=chunk-R6FINS25.js.map