@pyreon/core 0.3.0 → 0.3.1

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/lifecycle.ts","../src/component.ts","../src/context.ts","../src/h.ts","../src/dynamic.ts","../src/telemetry.ts","../src/error-boundary.ts","../src/for.ts","../src/lazy.ts","../src/map-array.ts","../src/portal.ts","../src/ref.ts","../src/show.ts","../src/suspense.ts"],"sourcesContent":["import type { CleanupFn, LifecycleHooks } from \"./types\"\n\n// The currently-executing component's hook storage, set by the renderer\n// before calling the component function, cleared immediately after.\nlet _current: LifecycleHooks | null = null\n\nexport function setCurrentHooks(hooks: LifecycleHooks | null) {\n  _current = hooks\n}\n\nexport function getCurrentHooks(): LifecycleHooks | null {\n  return _current\n}\n\n/**\n * Register a callback to run after the component is mounted to the DOM.\n * Optionally return a cleanup function — it will run on unmount.\n */\nexport function onMount(fn: () => CleanupFn | undefined) {\n  _current?.mount.push(fn)\n}\n\n/**\n * Register a callback to run when the component is removed from the DOM.\n */\nexport function onUnmount(fn: () => void) {\n  _current?.unmount.push(fn)\n}\n\n/**\n * Register a callback to run after each reactive update.\n */\nexport function onUpdate(fn: () => void) {\n  _current?.update.push(fn)\n}\n\n/**\n * Register an error handler for this component subtree.\n *\n * When an error is thrown during rendering or in a child component,\n * the nearest `onErrorCaptured` handler is called with the error.\n * Return `true` to mark the error as handled and stop propagation.\n *\n * @example\n * onErrorCaptured((err) => {\n *   setError(String(err))\n *   return true // handled — don't propagate\n * })\n */\nexport function onErrorCaptured(fn: (err: unknown) => boolean | undefined) {\n  _current?.error.push(fn)\n}\n","import { setCurrentHooks } from \"./lifecycle\"\nimport type { ComponentFn, LifecycleHooks, Props, VNode } from \"./types\"\n\n/**\n * Identity wrapper — marks a function as a Pyreon component and preserves its type.\n * Useful for IDE tooling and future compiler optimisations.\n */\nexport function defineComponent<P extends Props>(fn: ComponentFn<P>): ComponentFn<P> {\n  return fn\n}\n\n/**\n * Run a component function in a tracked context so that lifecycle hooks\n * registered inside it (onMount, onUnmount, onErrorCaptured, etc.) are captured.\n *\n * Called by the renderer — not intended for user code.\n */\nexport function runWithHooks<P extends Props>(\n  fn: ComponentFn<P>,\n  props: P,\n): { vnode: VNode | null; hooks: LifecycleHooks } {\n  const hooks: LifecycleHooks = { mount: [], unmount: [], update: [], error: [] }\n  setCurrentHooks(hooks)\n  let vnode: VNode | null = null\n  try {\n    vnode = fn(props)\n  } finally {\n    setCurrentHooks(null)\n  }\n  return { vnode, hooks }\n}\n\n/**\n * Walk up error handlers collected during component rendering.\n * Returns true if any handler marked the error as handled.\n */\nexport function propagateError(err: unknown, hooks: LifecycleHooks): boolean {\n  for (const handler of hooks.error) {\n    if (handler(err) === true) return true\n  }\n  return false\n}\n\n// ─── Error boundary stack ────────────────────────────────────────────────────\n// Module-level stack of active ErrorBoundary handlers (innermost last).\n// ErrorBoundary pushes during its own setup (before children mount) so that\n// any child mountComponent error can dispatch up to the nearest boundary.\n\nconst _errorBoundaryStack: ((err: unknown) => boolean)[] = []\n\nexport function pushErrorBoundary(handler: (err: unknown) => boolean): void {\n  _errorBoundaryStack.push(handler)\n}\n\nexport function popErrorBoundary(): void {\n  _errorBoundaryStack.pop()\n}\n\n/**\n * Dispatch an error to the nearest active ErrorBoundary.\n * Returns true if the boundary handled it, false if none was registered.\n */\nexport function dispatchToErrorBoundary(err: unknown): boolean {\n  const handler = _errorBoundaryStack[_errorBoundaryStack.length - 1]\n  return handler ? handler(err) : false\n}\n","/**\n * Provide / inject — like React context or Vue provide/inject.\n *\n * Values flow down the component tree without prop-drilling.\n * The renderer maintains the context stack as it walks the VNode tree.\n */\n\nexport interface Context<T> {\n  readonly id: symbol\n  readonly defaultValue: T\n}\n\nexport function createContext<T>(defaultValue: T): Context<T> {\n  return { id: Symbol(\"PyreonContext\"), defaultValue }\n}\n\n// ─── Runtime context stack (managed by the renderer) ─────────────────────────\n\n// Default stack — used for CSR and single-threaded SSR.\n// On Node.js with concurrent requests, @pyreon/runtime-server replaces this with\n// an AsyncLocalStorage-backed provider via setContextStackProvider().\nconst _defaultStack: Map<symbol, unknown>[] = []\nlet _stackProvider: () => Map<symbol, unknown>[] = () => _defaultStack\n\n/**\n * Override the context stack provider. Called by @pyreon/runtime-server to\n * inject an AsyncLocalStorage-backed stack that isolates concurrent SSR requests.\n * Has no effect in the browser (CSR always uses the default module-level stack).\n */\nexport function setContextStackProvider(fn: () => Map<symbol, unknown>[]): void {\n  _stackProvider = fn\n}\n\nfunction getStack(): Map<symbol, unknown>[] {\n  return _stackProvider()\n}\n\nconst __DEV__ = typeof process !== \"undefined\" && process.env.NODE_ENV !== \"production\"\n\nexport function pushContext(values: Map<symbol, unknown>) {\n  getStack().push(values)\n}\n\nexport function popContext() {\n  const stack = getStack()\n  if (__DEV__ && stack.length === 0) {\n    return\n  }\n  stack.pop()\n}\n\n/**\n * Read the nearest provided value for a context.\n * Falls back to `context.defaultValue` if none found.\n */\nexport function useContext<T>(context: Context<T>): T {\n  const stack = getStack()\n  for (let i = stack.length - 1; i >= 0; i--) {\n    const frame = stack[i]\n    if (frame?.has(context.id)) {\n      return frame.get(context.id) as T\n    }\n  }\n  return context.defaultValue\n}\n\n/**\n * Provide a value for `context` during `fn()`.\n * Used by the renderer when it encounters a `<Provider>` component.\n */\nexport function withContext<T>(context: Context<T>, value: T, fn: () => void) {\n  const frame = new Map<symbol, unknown>([[context.id, value]])\n  pushContext(frame)\n  try {\n    fn()\n  } finally {\n    popContext()\n  }\n}\n","import type { ComponentFn, Props, VNode, VNodeChild } from \"./types\"\n\n/** Marker for fragment nodes — renders children without a wrapper element */\nexport const Fragment: unique symbol = Symbol(\"Pyreon.Fragment\")\n\n/**\n * Hyperscript function — the compiled output of JSX.\n * `<div class=\"x\">hello</div>` → `h(\"div\", { class: \"x\" }, \"hello\")`\n *\n * Generic on P so TypeScript validates props match the component's signature\n * at the call site, then stores the result in the loosely-typed VNode.\n */\n/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */\nexport const EMPTY_PROPS: Props = {} as Props\n\nexport function h<P extends Props>(\n  type: string | ComponentFn<P> | symbol,\n  props: P | null,\n  ...children: VNodeChild[]\n): VNode {\n  return {\n    type: type as string | ComponentFn | symbol,\n    props: (props ?? EMPTY_PROPS) as Props,\n    children: normalizeChildren(children),\n    key: (props?.key as string | number | null) ?? null,\n  }\n}\n\nfunction normalizeChildren(children: VNodeChild[]): VNodeChild[] {\n  // Fast path: no nested arrays — return as-is without allocating\n  for (let i = 0; i < children.length; i++) {\n    if (Array.isArray(children[i])) {\n      return flattenChildren(children)\n    }\n  }\n  return children\n}\n\nfunction flattenChildren(children: VNodeChild[]): VNodeChild[] {\n  const result: VNodeChild[] = []\n  for (const child of children) {\n    if (Array.isArray(child)) {\n      result.push(...flattenChildren(child as VNodeChild[]))\n    } else {\n      result.push(child)\n    }\n  }\n  return result\n}\n","import { h } from \"./h\"\nimport type { ComponentFn, Props, VNode } from \"./types\"\n\nexport interface DynamicProps extends Props {\n  component: ComponentFn | string\n}\n\nexport function Dynamic(props: DynamicProps): VNode | null {\n  const { component, ...rest } = props\n  if (!component) return null\n  return h(component as string | ComponentFn, rest as Props)\n}\n","/**\n * Error telemetry — hook into Pyreon's error reporting for Sentry, Datadog, etc.\n *\n * @example\n * import { registerErrorHandler } from \"@pyreon/core\"\n * import * as Sentry from \"@sentry/browser\"\n *\n * registerErrorHandler(ctx => {\n *   Sentry.captureException(ctx.error, {\n *     extra: { component: ctx.component, phase: ctx.phase },\n *   })\n * })\n */\n\nexport interface ErrorContext {\n  /** Component function name, or \"Anonymous\" */\n  component: string\n  /** Lifecycle phase where the error occurred */\n  phase: \"setup\" | \"render\" | \"mount\" | \"unmount\" | \"effect\"\n  /** The thrown value */\n  error: unknown\n  /** Unix timestamp (ms) */\n  timestamp: number\n  /** Component props at the time of the error */\n  props?: Record<string, unknown>\n}\n\nexport type ErrorHandler = (ctx: ErrorContext) => void\n\nlet _handlers: ErrorHandler[] = []\n\n/**\n * Register a global error handler. Called whenever a component throws in any\n * lifecycle phase. Returns an unregister function.\n */\nexport function registerErrorHandler(handler: ErrorHandler): () => void {\n  _handlers.push(handler)\n  return () => {\n    _handlers = _handlers.filter((h) => h !== handler)\n  }\n}\n\n/**\n * Internal — called by the runtime whenever a component error is caught.\n * Existing console.error calls are preserved; this is additive.\n */\nexport function reportError(ctx: ErrorContext): void {\n  for (const h of _handlers) {\n    try {\n      h(ctx)\n    } catch {\n      // handler errors must never propagate back into the framework\n    }\n  }\n}\n","import { signal } from \"@pyreon/reactivity\"\nimport { popErrorBoundary, pushErrorBoundary } from \"./component\"\nimport { onUnmount } from \"./lifecycle\"\nimport { reportError } from \"./telemetry\"\nimport type { VNodeChild, VNodeChildAtom } from \"./types\"\n\n/**\n * ErrorBoundary — catches errors thrown by child components and renders a\n * fallback UI instead of crashing the whole tree.\n *\n * Also reports caught errors to any registered telemetry handlers.\n *\n * How error propagation works:\n * ErrorBoundary pushes a handler onto the module-level boundary stack\n * synchronously during its own setup (before children are mounted).\n * When mountComponent catches a child error, it calls dispatchToErrorBoundary()\n * which invokes the innermost boundary's handler.\n *\n * Usage:\n *   h(ErrorBoundary, {\n *     fallback: (err) => h(\"p\", null, `Error: ${err}`),\n *     children: h(MyComponent, null),\n *   })\n *\n *   // or with JSX:\n *   <ErrorBoundary fallback={(err) => <p>Error: {String(err)}</p>}>\n *     <MyComponent />\n *   </ErrorBoundary>\n */\nexport function ErrorBoundary(props: {\n  /**\n   * Rendered when a child throws. Receives the caught error and a `reset`\n   * function — calling `reset()` clears the error and re-renders children.\n   */\n  fallback: (err: unknown, reset: () => void) => VNodeChild\n  children?: VNodeChild\n}): VNodeChild {\n  const error = signal<unknown>(null)\n  const reset = () => error.set(null)\n\n  const handler = (err: unknown): boolean => {\n    if (error.peek() !== null) return false // already in error state — let outer boundary catch it\n    error.set(err)\n    reportError({ component: \"ErrorBoundary\", phase: \"render\", error: err, timestamp: Date.now() })\n    return true\n  }\n\n  // Push synchronously — before children are mounted — so child errors see this boundary\n  pushErrorBoundary(handler)\n  onUnmount(() => popErrorBoundary())\n\n  return (): VNodeChildAtom => {\n    const err = error()\n    if (err != null) return props.fallback(err, reset) as VNodeChildAtom\n    const ch = props.children\n    return (typeof ch === \"function\" ? ch() : ch) as VNodeChildAtom\n  }\n}\n","import type { NativeItem, Props, VNode } from \"./types\"\n\n/**\n * Symbol used as the VNode type for a For list — runtime-dom handles it\n * via mountFor, bypassing the generic VNode reconciler.\n */\nexport const ForSymbol: unique symbol = Symbol(\"pyreon.For\")\n\nexport interface ForProps<T> {\n  each: () => T[]\n  by: (item: T) => string | number\n  children: (item: T) => VNode | NativeItem\n}\n\n/**\n * Efficient reactive list rendering.\n *\n * Unlike a plain `() => items().map(item => h(...))`, For never re-creates\n * VNodes for existing keys — only new keys invoke `children()`. Structural\n * mutations (swap, sort, filter) are O(n) key scan + O(k) DOM moves where k\n * is the number of actually displaced entries.\n *\n * Usage:\n *   <For each={items} by={r => r.id}>{r => <li>...</li>}</For>\n */\nexport function For<T>(props: ForProps<T>): VNode {\n  return {\n    type: ForSymbol as unknown as string,\n    props: props as unknown as Props,\n    children: [],\n    key: null,\n  }\n}\n","import { signal } from \"@pyreon/reactivity\"\nimport { h } from \"./h\"\nimport type { LazyComponent } from \"./suspense\"\nimport type { ComponentFn, Props } from \"./types\"\n\nexport function lazy<P extends Props>(\n  load: () => Promise<{ default: ComponentFn<P> }>,\n): LazyComponent<P> {\n  const loaded = signal<ComponentFn<P> | null>(null)\n  const error = signal<Error | null>(null)\n\n  load()\n    .then((m) => loaded.set(m.default))\n    .catch((e) => error.set(e instanceof Error ? e : new Error(String(e))))\n\n  const wrapper = ((props: P) => {\n    const err = error()\n    if (err) throw err\n    const comp = loaded()\n    return comp ? h(comp as ComponentFn, props as Props) : null\n  }) as LazyComponent<P>\n\n  wrapper.__loading = () => loaded() === null && error() === null\n  return wrapper\n}\n","/**\n * mapArray — keyed reactive list mapping.\n *\n * Creates each mapped item exactly once per key, then reuses it across\n * updates. When the source array is reordered or partially changed, only\n * new keys invoke `map()`; existing entries return the cached result.\n *\n * This makes structural list operations (swap, sort, filter) O(k) in\n * allocations where k is the number of new/removed keys, not O(n).\n *\n * The returned accessor reads `source()` reactively, so it can be passed\n * directly to the keyed-list reconciler.\n */\nexport function mapArray<T, U>(\n  source: () => T[],\n  getKey: (item: T) => string | number,\n  map: (item: T) => U,\n): () => U[] {\n  const cache = new Map<string | number, U>()\n\n  return () => {\n    const items = source()\n    const result: U[] = []\n    const newKeys = new Set<string | number>()\n\n    for (const item of items) {\n      const key = getKey(item)\n      newKeys.add(key)\n      if (!cache.has(key)) {\n        cache.set(key, map(item))\n      }\n      result.push(cache.get(key) as U)\n    }\n\n    // Evict entries whose keys are no longer present\n    for (const key of cache.keys()) {\n      if (!newKeys.has(key)) cache.delete(key)\n    }\n\n    return result\n  }\n}\n","import type { Props, VNode, VNodeChild } from \"./types\"\n\n/**\n * Symbol used as the VNode type for a Portal — runtime-dom mounts the\n * children into `target` instead of the normal parent.\n */\nexport const PortalSymbol: unique symbol = Symbol(\"pyreon.Portal\")\n\nexport interface PortalProps {\n  /** DOM element to render children into (e.g. document.body). */\n  target: Element\n  children: VNodeChild\n}\n\n/**\n * Portal — renders `children` into a different DOM node than the\n * current parent tree.\n *\n * Useful for modals, tooltips, dropdowns, and any overlay that needs to\n * escape CSS overflow/stacking context restrictions.\n *\n * @example\n * // Render a modal at document.body level regardless of where in the\n * // component tree <Modal> is used:\n * Portal({ target: document.body, children: h(Modal, { onClose }) })\n *\n * // JSX:\n * <Portal target={document.body}>\n *   <Modal onClose={close} />\n * </Portal>\n */\nexport function Portal(props: PortalProps): VNode {\n  return {\n    type: PortalSymbol as unknown as string,\n    props: props as unknown as Props,\n    children: [],\n    key: null,\n  }\n}\n","/**\n * createRef — mutable container for a DOM element or component value.\n *\n * Usage:\n *   const inputRef = createRef<HTMLInputElement>()\n *   onMount(() => { inputRef.current?.focus() })\n *   return <input ref={inputRef} />\n *\n * The runtime sets `ref.current` after the element is inserted into the DOM\n * and clears it to `null` when the element is removed.\n */\n\nexport interface Ref<T = unknown> {\n  current: T | null\n}\n\nexport function createRef<T = unknown>(): Ref<T> {\n  return { current: null }\n}\n","import type { Props, VNode, VNodeChild, VNodeChildAtom } from \"./types\"\n\n// ─── Show ─────────────────────────────────────────────────────────────────────\n\nexport interface ShowProps extends Props {\n  /** Accessor — children render when truthy, fallback when falsy. */\n  when: () => unknown\n  fallback?: VNodeChild\n  children?: VNodeChild\n}\n\n/**\n * Conditionally render children based on a reactive condition.\n *\n * @example\n * h(Show, { when: () => isLoggedIn() },\n *   h(Dashboard, null)\n * )\n *\n * // With fallback:\n * h(Show, { when: () => user(), fallback: h(Login, null) },\n *   h(Dashboard, null)\n * )\n */\nexport function Show(props: ShowProps): VNode | null {\n  // Returns a reactive accessor; the renderer unwraps it at mount time.\n  return ((): VNodeChildAtom =>\n    (props.when()\n      ? (props.children ?? null)\n      : (props.fallback ?? null)) as VNodeChildAtom) as unknown as VNode\n}\n\n// ─── Switch / Match ───────────────────────────────────────────────────────────\n\nexport interface MatchProps extends Props {\n  /** Accessor — this branch renders when truthy. */\n  when: () => unknown\n  children?: VNodeChild\n}\n\n/**\n * A branch inside `<Switch>`. Renders when `when()` is truthy.\n * Must be used as a direct child of `Switch`.\n *\n * `Match` acts as a pure type/identity marker — Switch identifies it by checking\n * `vnode.type === Match` rather than by the runtime return value.\n */\nexport function Match(_props: MatchProps): VNode | null {\n  // Match is never mounted directly — Switch inspects Match VNodes by type identity.\n  return null\n}\n\nexport interface SwitchProps extends Props {\n  /** Rendered when no Match branch is truthy. */\n  fallback?: VNodeChild\n  children?: VNodeChild | VNodeChild[]\n}\n\n/**\n * Multi-branch conditional rendering. Evaluates each `Match` child in order,\n * renders the first whose `when()` is truthy, or `fallback` if none match.\n *\n * @example\n * h(Switch, { fallback: h(\"p\", null, \"404\") },\n *   h(Match, { when: () => route() === \"/\" }, h(Home, null)),\n *   h(Match, { when: () => route() === \"/about\" }, h(About, null)),\n * )\n */\nfunction isMatchVNode(branch: VNodeChild): branch is VNode {\n  return (\n    branch !== null &&\n    typeof branch === \"object\" &&\n    !Array.isArray(branch) &&\n    (branch as VNode).type === Match\n  )\n}\n\nfunction resolveMatchChildren(matchVNode: VNode): VNodeChildAtom {\n  if (matchVNode.children.length === 0) {\n    return ((matchVNode.props as unknown as MatchProps).children ?? null) as VNodeChildAtom\n  }\n  if (matchVNode.children.length === 1) return matchVNode.children[0] as VNodeChildAtom\n  return matchVNode.children as unknown as VNodeChildAtom\n}\n\nfunction normalizeBranches(children: SwitchProps[\"children\"]): VNodeChild[] {\n  if (Array.isArray(children)) return children\n  if (children != null) return [children]\n  return []\n}\n\nexport function Switch(props: SwitchProps): VNode | null {\n  // Returns a reactive accessor; the renderer unwraps it at mount time.\n  return ((): VNodeChildAtom => {\n    const branches = normalizeBranches(props.children)\n\n    for (const branch of branches) {\n      if (!isMatchVNode(branch)) continue\n      const matchProps = branch.props as unknown as MatchProps\n      if (matchProps.when()) return resolveMatchChildren(branch)\n    }\n\n    return (props.fallback ?? null) as VNodeChildAtom\n  }) as unknown as VNode\n}\n\n// Keep MatchSymbol export for any code that was using it\nexport const MatchSymbol: unique symbol = Symbol(\"pyreon.Match\")\n","import { Fragment, h } from \"./h\"\nimport type { Props, VNode, VNodeChild } from \"./types\"\n\n/** Internal marker attached to lazy()-wrapped components */\nexport type LazyComponent<P extends Props = Props> = ((props: P) => VNode | null) & {\n  __loading: () => boolean\n}\n\n/**\n * Suspense — shows `fallback` while a lazy child component is still loading.\n *\n * Works in tandem with `lazy()` from `@pyreon/react-compat` (or `@pyreon/core/lazy`).\n * The child VNode's `.type.__loading()` signal drives the switch.\n *\n * Usage:\n *   const Page = lazy(() => import(\"./Page\"))\n *\n *   h(Suspense, { fallback: h(Spinner, null) }, h(Page, null))\n *   // or with JSX:\n *   <Suspense fallback={<Spinner />}><Page /></Suspense>\n */\nexport function Suspense(props: { fallback: VNodeChild; children?: VNodeChild }): VNode {\n  return h(Fragment, null, () => {\n    const ch = props.children\n    const childNode = typeof ch === \"function\" ? ch() : ch\n\n    // Check if the child is a VNode whose type is a lazy component still loading\n    const isLoading =\n      childNode != null &&\n      typeof childNode === \"object\" &&\n      !Array.isArray(childNode) &&\n      typeof (childNode as VNode).type === \"function\" &&\n      ((childNode as VNode).type as unknown as LazyComponent).__loading?.()\n\n    if (isLoading) {\n      const fb = props.fallback\n      return typeof fb === \"function\" ? fb() : fb\n    }\n    return childNode\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/lifecycle.ts","../src/component.ts","../src/context.ts","../src/h.ts","../src/dynamic.ts","../src/telemetry.ts","../src/error-boundary.ts","../src/for.ts","../src/lazy.ts","../src/map-array.ts","../src/portal.ts","../src/ref.ts","../src/show.ts","../src/suspense.ts"],"sourcesContent":["import type { CleanupFn, LifecycleHooks } from \"./types\"\n\n// The currently-executing component's hook storage, set by the renderer\n// before calling the component function, cleared immediately after.\nlet _current: LifecycleHooks | null = null\n\nexport function setCurrentHooks(hooks: LifecycleHooks | null) {\n  _current = hooks\n}\n\nexport function getCurrentHooks(): LifecycleHooks | null {\n  return _current\n}\n\n/**\n * Register a callback to run after the component is mounted to the DOM.\n * Optionally return a cleanup function — it will run on unmount.\n */\nexport function onMount(fn: () => CleanupFn | undefined) {\n  _current?.mount.push(fn)\n}\n\n/**\n * Register a callback to run when the component is removed from the DOM.\n */\nexport function onUnmount(fn: () => void) {\n  _current?.unmount.push(fn)\n}\n\n/**\n * Register a callback to run after each reactive update.\n */\nexport function onUpdate(fn: () => void) {\n  _current?.update.push(fn)\n}\n\n/**\n * Register an error handler for this component subtree.\n *\n * When an error is thrown during rendering or in a child component,\n * the nearest `onErrorCaptured` handler is called with the error.\n * Return `true` to mark the error as handled and stop propagation.\n *\n * @example\n * onErrorCaptured((err) => {\n *   setError(String(err))\n *   return true // handled — don't propagate\n * })\n */\nexport function onErrorCaptured(fn: (err: unknown) => boolean | undefined) {\n  _current?.error.push(fn)\n}\n","import { setCurrentHooks } from \"./lifecycle\"\nimport type { ComponentFn, LifecycleHooks, Props, VNode } from \"./types\"\n\n/**\n * Identity wrapper — marks a function as a Pyreon component and preserves its type.\n * Useful for IDE tooling and future compiler optimisations.\n */\nexport function defineComponent<P extends Props>(fn: ComponentFn<P>): ComponentFn<P> {\n  return fn\n}\n\n/**\n * Run a component function in a tracked context so that lifecycle hooks\n * registered inside it (onMount, onUnmount, onErrorCaptured, etc.) are captured.\n *\n * Called by the renderer — not intended for user code.\n */\nexport function runWithHooks<P extends Props>(\n  fn: ComponentFn<P>,\n  props: P,\n): { vnode: VNode | null; hooks: LifecycleHooks } {\n  const hooks: LifecycleHooks = { mount: [], unmount: [], update: [], error: [] }\n  setCurrentHooks(hooks)\n  let vnode: VNode | null = null\n  try {\n    vnode = fn(props)\n  } finally {\n    setCurrentHooks(null)\n  }\n  return { vnode, hooks }\n}\n\n/**\n * Walk up error handlers collected during component rendering.\n * Returns true if any handler marked the error as handled.\n */\nexport function propagateError(err: unknown, hooks: LifecycleHooks): boolean {\n  for (const handler of hooks.error) {\n    if (handler(err) === true) return true\n  }\n  return false\n}\n\n// ─── Error boundary stack ────────────────────────────────────────────────────\n// Module-level stack of active ErrorBoundary handlers (innermost last).\n// ErrorBoundary pushes during its own setup (before children mount) so that\n// any child mountComponent error can dispatch up to the nearest boundary.\n\nconst _errorBoundaryStack: ((err: unknown) => boolean)[] = []\n\nexport function pushErrorBoundary(handler: (err: unknown) => boolean): void {\n  _errorBoundaryStack.push(handler)\n}\n\nexport function popErrorBoundary(): void {\n  _errorBoundaryStack.pop()\n}\n\n/**\n * Dispatch an error to the nearest active ErrorBoundary.\n * Returns true if the boundary handled it, false if none was registered.\n */\nexport function dispatchToErrorBoundary(err: unknown): boolean {\n  const handler = _errorBoundaryStack[_errorBoundaryStack.length - 1]\n  return handler ? handler(err) : false\n}\n","/**\n * Provide / inject — like React context or Vue provide/inject.\n *\n * Values flow down the component tree without prop-drilling.\n * The renderer maintains the context stack as it walks the VNode tree.\n */\n\nexport interface Context<T> {\n  readonly id: symbol\n  readonly defaultValue: T\n}\n\nexport function createContext<T>(defaultValue: T): Context<T> {\n  return { id: Symbol(\"PyreonContext\"), defaultValue }\n}\n\n// ─── Runtime context stack (managed by the renderer) ─────────────────────────\n\n// Default stack — used for CSR and single-threaded SSR.\n// On Node.js with concurrent requests, @pyreon/runtime-server replaces this with\n// an AsyncLocalStorage-backed provider via setContextStackProvider().\nconst _defaultStack: Map<symbol, unknown>[] = []\nlet _stackProvider: () => Map<symbol, unknown>[] = () => _defaultStack\n\n/**\n * Override the context stack provider. Called by @pyreon/runtime-server to\n * inject an AsyncLocalStorage-backed stack that isolates concurrent SSR requests.\n * Has no effect in the browser (CSR always uses the default module-level stack).\n */\nexport function setContextStackProvider(fn: () => Map<symbol, unknown>[]): void {\n  _stackProvider = fn\n}\n\nfunction getStack(): Map<symbol, unknown>[] {\n  return _stackProvider()\n}\n\nconst __DEV__ = typeof process !== \"undefined\" && process.env.NODE_ENV !== \"production\"\n\nexport function pushContext(values: Map<symbol, unknown>) {\n  getStack().push(values)\n}\n\nexport function popContext() {\n  const stack = getStack()\n  if (__DEV__ && stack.length === 0) {\n    return\n  }\n  stack.pop()\n}\n\n/**\n * Read the nearest provided value for a context.\n * Falls back to `context.defaultValue` if none found.\n */\nexport function useContext<T>(context: Context<T>): T {\n  const stack = getStack()\n  for (let i = stack.length - 1; i >= 0; i--) {\n    const frame = stack[i]\n    if (frame?.has(context.id)) {\n      return frame.get(context.id) as T\n    }\n  }\n  return context.defaultValue\n}\n\n/**\n * Provide a value for `context` during `fn()`.\n * Used by the renderer when it encounters a `<Provider>` component.\n */\nexport function withContext<T>(context: Context<T>, value: T, fn: () => void) {\n  const frame = new Map<symbol, unknown>([[context.id, value]])\n  pushContext(frame)\n  try {\n    fn()\n  } finally {\n    popContext()\n  }\n}\n","import type { ComponentFn, Props, VNode, VNodeChild } from \"./types\"\n\n/** Marker for fragment nodes — renders children without a wrapper element */\nexport const Fragment: unique symbol = Symbol(\"Pyreon.Fragment\")\n\n/**\n * Hyperscript function — the compiled output of JSX.\n * `<div class=\"x\">hello</div>` → `h(\"div\", { class: \"x\" }, \"hello\")`\n *\n * Generic on P so TypeScript validates props match the component's signature\n * at the call site, then stores the result in the loosely-typed VNode.\n */\n/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */\nexport const EMPTY_PROPS: Props = {} as Props\n\n/** Makes `children` optional in P (if present) so it can be passed as rest args to h(). */\ntype PropsWithOptionalChildren<P extends Props> = Omit<P, \"children\"> &\n  (\"children\" extends keyof P ? { children?: P[\"children\"] } : unknown)\n\n// Overload: component with typed props — children is optional in the props object\n// because it can be passed as rest args. Extra keys are allowed via `& Props`.\nexport function h<P extends Props>(\n  type: ComponentFn<P>,\n  props: (PropsWithOptionalChildren<P> & Props) | null,\n  ...children: VNodeChild[]\n): VNode\n// Overload: intrinsic element, symbol, generic/dynamic component, or mixed union\n// biome-ignore lint/suspicious/noExplicitAny: accepts any component function for generic components like For<T>\nexport function h(\n  type: string | ((props: any) => VNode | null) | symbol,\n  props: Props | null,\n  ...children: VNodeChild[]\n): VNode\nexport function h<P extends Props>(\n  type: string | ComponentFn<P> | symbol,\n  props: P | null,\n  ...children: VNodeChild[]\n): VNode {\n  return {\n    type: type as string | ComponentFn | symbol,\n    props: (props ?? EMPTY_PROPS) as Props,\n    children: normalizeChildren(children),\n    key: (props?.key as string | number | null) ?? null,\n  }\n}\n\nfunction normalizeChildren(children: VNodeChild[]): VNodeChild[] {\n  // Fast path: no nested arrays — return as-is without allocating\n  for (let i = 0; i < children.length; i++) {\n    if (Array.isArray(children[i])) {\n      return flattenChildren(children)\n    }\n  }\n  return children\n}\n\nfunction flattenChildren(children: VNodeChild[]): VNodeChild[] {\n  const result: VNodeChild[] = []\n  for (const child of children) {\n    if (Array.isArray(child)) {\n      result.push(...flattenChildren(child as VNodeChild[]))\n    } else {\n      result.push(child)\n    }\n  }\n  return result\n}\n","import { h } from \"./h\"\nimport type { ComponentFn, Props, VNode } from \"./types\"\n\nexport interface DynamicProps extends Props {\n  component: ComponentFn | string\n}\n\nexport function Dynamic(props: DynamicProps): VNode | null {\n  const { component, ...rest } = props\n  if (!component) return null\n  return h(component as string | ComponentFn, rest as Props)\n}\n","/**\n * Error telemetry — hook into Pyreon's error reporting for Sentry, Datadog, etc.\n *\n * @example\n * import { registerErrorHandler } from \"@pyreon/core\"\n * import * as Sentry from \"@sentry/browser\"\n *\n * registerErrorHandler(ctx => {\n *   Sentry.captureException(ctx.error, {\n *     extra: { component: ctx.component, phase: ctx.phase },\n *   })\n * })\n */\n\nexport interface ErrorContext {\n  /** Component function name, or \"Anonymous\" */\n  component: string\n  /** Lifecycle phase where the error occurred */\n  phase: \"setup\" | \"render\" | \"mount\" | \"unmount\" | \"effect\"\n  /** The thrown value */\n  error: unknown\n  /** Unix timestamp (ms) */\n  timestamp: number\n  /** Component props at the time of the error */\n  props?: Record<string, unknown>\n}\n\nexport type ErrorHandler = (ctx: ErrorContext) => void\n\nlet _handlers: ErrorHandler[] = []\n\n/**\n * Register a global error handler. Called whenever a component throws in any\n * lifecycle phase. Returns an unregister function.\n */\nexport function registerErrorHandler(handler: ErrorHandler): () => void {\n  _handlers.push(handler)\n  return () => {\n    _handlers = _handlers.filter((h) => h !== handler)\n  }\n}\n\n/**\n * Internal — called by the runtime whenever a component error is caught.\n * Existing console.error calls are preserved; this is additive.\n */\nexport function reportError(ctx: ErrorContext): void {\n  for (const h of _handlers) {\n    try {\n      h(ctx)\n    } catch {\n      // handler errors must never propagate back into the framework\n    }\n  }\n}\n","import { signal } from \"@pyreon/reactivity\"\nimport { popErrorBoundary, pushErrorBoundary } from \"./component\"\nimport { onUnmount } from \"./lifecycle\"\nimport { reportError } from \"./telemetry\"\nimport type { VNodeChild, VNodeChildAtom } from \"./types\"\n\n/**\n * ErrorBoundary — catches errors thrown by child components and renders a\n * fallback UI instead of crashing the whole tree.\n *\n * Also reports caught errors to any registered telemetry handlers.\n *\n * How error propagation works:\n * ErrorBoundary pushes a handler onto the module-level boundary stack\n * synchronously during its own setup (before children are mounted).\n * When mountComponent catches a child error, it calls dispatchToErrorBoundary()\n * which invokes the innermost boundary's handler.\n *\n * Usage:\n *   h(ErrorBoundary, {\n *     fallback: (err) => h(\"p\", null, `Error: ${err}`),\n *     children: h(MyComponent, null),\n *   })\n *\n *   // or with JSX:\n *   <ErrorBoundary fallback={(err) => <p>Error: {String(err)}</p>}>\n *     <MyComponent />\n *   </ErrorBoundary>\n */\nexport function ErrorBoundary(props: {\n  /**\n   * Rendered when a child throws. Receives the caught error and a `reset`\n   * function — calling `reset()` clears the error and re-renders children.\n   */\n  fallback: (err: unknown, reset: () => void) => VNodeChild\n  children?: VNodeChild\n}): VNodeChild {\n  const error = signal<unknown>(null)\n  const reset = () => error.set(null)\n\n  const handler = (err: unknown): boolean => {\n    if (error.peek() !== null) return false // already in error state — let outer boundary catch it\n    error.set(err)\n    reportError({ component: \"ErrorBoundary\", phase: \"render\", error: err, timestamp: Date.now() })\n    return true\n  }\n\n  // Push synchronously — before children are mounted — so child errors see this boundary\n  pushErrorBoundary(handler)\n  onUnmount(() => popErrorBoundary())\n\n  return (): VNodeChildAtom => {\n    const err = error()\n    if (err != null) return props.fallback(err, reset) as VNodeChildAtom\n    const ch = props.children\n    return (typeof ch === \"function\" ? ch() : ch) as VNodeChildAtom\n  }\n}\n","import type { NativeItem, Props, VNode } from \"./types\"\n\n/**\n * Symbol used as the VNode type for a For list — runtime-dom handles it\n * via mountFor, bypassing the generic VNode reconciler.\n */\nexport const ForSymbol: unique symbol = Symbol(\"pyreon.For\")\n\nexport interface ForProps<T> {\n  each: () => T[]\n  by: (item: T) => string | number\n  children: (item: T) => VNode | NativeItem\n}\n\n/**\n * Efficient reactive list rendering.\n *\n * Unlike a plain `() => items().map(item => h(...))`, For never re-creates\n * VNodes for existing keys — only new keys invoke `children()`. Structural\n * mutations (swap, sort, filter) are O(n) key scan + O(k) DOM moves where k\n * is the number of actually displaced entries.\n *\n * Usage:\n *   <For each={items} by={r => r.id}>{r => <li>...</li>}</For>\n */\nexport function For<T>(props: ForProps<T>): VNode {\n  return {\n    type: ForSymbol as unknown as string,\n    props: props as unknown as Props,\n    children: [],\n    key: null,\n  }\n}\n","import { signal } from \"@pyreon/reactivity\"\nimport { h } from \"./h\"\nimport type { LazyComponent } from \"./suspense\"\nimport type { ComponentFn, Props } from \"./types\"\n\nexport function lazy<P extends Props>(\n  load: () => Promise<{ default: ComponentFn<P> }>,\n): LazyComponent<P> {\n  const loaded = signal<ComponentFn<P> | null>(null)\n  const error = signal<Error | null>(null)\n\n  load()\n    .then((m) => loaded.set(m.default))\n    .catch((e) => error.set(e instanceof Error ? e : new Error(String(e))))\n\n  const wrapper = ((props: P) => {\n    const err = error()\n    if (err) throw err\n    const comp = loaded()\n    return comp ? h(comp as ComponentFn, props as Props) : null\n  }) as LazyComponent<P>\n\n  wrapper.__loading = () => loaded() === null && error() === null\n  return wrapper\n}\n","/**\n * mapArray — keyed reactive list mapping.\n *\n * Creates each mapped item exactly once per key, then reuses it across\n * updates. When the source array is reordered or partially changed, only\n * new keys invoke `map()`; existing entries return the cached result.\n *\n * This makes structural list operations (swap, sort, filter) O(k) in\n * allocations where k is the number of new/removed keys, not O(n).\n *\n * The returned accessor reads `source()` reactively, so it can be passed\n * directly to the keyed-list reconciler.\n */\nexport function mapArray<T, U>(\n  source: () => T[],\n  getKey: (item: T) => string | number,\n  map: (item: T) => U,\n): () => U[] {\n  const cache = new Map<string | number, U>()\n\n  return () => {\n    const items = source()\n    const result: U[] = []\n    const newKeys = new Set<string | number>()\n\n    for (const item of items) {\n      const key = getKey(item)\n      newKeys.add(key)\n      if (!cache.has(key)) {\n        cache.set(key, map(item))\n      }\n      result.push(cache.get(key) as U)\n    }\n\n    // Evict entries whose keys are no longer present\n    for (const key of cache.keys()) {\n      if (!newKeys.has(key)) cache.delete(key)\n    }\n\n    return result\n  }\n}\n","import type { Props, VNode, VNodeChild } from \"./types\"\n\n/**\n * Symbol used as the VNode type for a Portal — runtime-dom mounts the\n * children into `target` instead of the normal parent.\n */\nexport const PortalSymbol: unique symbol = Symbol(\"pyreon.Portal\")\n\nexport interface PortalProps {\n  /** DOM element to render children into (e.g. document.body). */\n  target: Element\n  children: VNodeChild\n}\n\n/**\n * Portal — renders `children` into a different DOM node than the\n * current parent tree.\n *\n * Useful for modals, tooltips, dropdowns, and any overlay that needs to\n * escape CSS overflow/stacking context restrictions.\n *\n * @example\n * // Render a modal at document.body level regardless of where in the\n * // component tree <Modal> is used:\n * Portal({ target: document.body, children: h(Modal, { onClose }) })\n *\n * // JSX:\n * <Portal target={document.body}>\n *   <Modal onClose={close} />\n * </Portal>\n */\nexport function Portal(props: PortalProps): VNode {\n  return {\n    type: PortalSymbol as unknown as string,\n    props: props as unknown as Props,\n    children: [],\n    key: null,\n  }\n}\n","/**\n * createRef — mutable container for a DOM element or component value.\n *\n * Usage:\n *   const inputRef = createRef<HTMLInputElement>()\n *   onMount(() => { inputRef.current?.focus() })\n *   return <input ref={inputRef} />\n *\n * The runtime sets `ref.current` after the element is inserted into the DOM\n * and clears it to `null` when the element is removed.\n */\n\nexport interface Ref<T = unknown> {\n  current: T | null\n}\n\nexport function createRef<T = unknown>(): Ref<T> {\n  return { current: null }\n}\n","import type { Props, VNode, VNodeChild, VNodeChildAtom } from \"./types\"\n\n// ─── Show ─────────────────────────────────────────────────────────────────────\n\nexport interface ShowProps extends Props {\n  /** Accessor — children render when truthy, fallback when falsy. */\n  when: () => unknown\n  fallback?: VNodeChild\n  children?: VNodeChild\n}\n\n/**\n * Conditionally render children based on a reactive condition.\n *\n * @example\n * h(Show, { when: () => isLoggedIn() },\n *   h(Dashboard, null)\n * )\n *\n * // With fallback:\n * h(Show, { when: () => user(), fallback: h(Login, null) },\n *   h(Dashboard, null)\n * )\n */\nexport function Show(props: ShowProps): VNode | null {\n  // Returns a reactive accessor; the renderer unwraps it at mount time.\n  return ((): VNodeChildAtom =>\n    (props.when()\n      ? (props.children ?? null)\n      : (props.fallback ?? null)) as VNodeChildAtom) as unknown as VNode\n}\n\n// ─── Switch / Match ───────────────────────────────────────────────────────────\n\nexport interface MatchProps extends Props {\n  /** Accessor — this branch renders when truthy. */\n  when: () => unknown\n  children?: VNodeChild\n}\n\n/**\n * A branch inside `<Switch>`. Renders when `when()` is truthy.\n * Must be used as a direct child of `Switch`.\n *\n * `Match` acts as a pure type/identity marker — Switch identifies it by checking\n * `vnode.type === Match` rather than by the runtime return value.\n */\nexport function Match(_props: MatchProps): VNode | null {\n  // Match is never mounted directly — Switch inspects Match VNodes by type identity.\n  return null\n}\n\nexport interface SwitchProps extends Props {\n  /** Rendered when no Match branch is truthy. */\n  fallback?: VNodeChild\n  children?: VNodeChild | VNodeChild[]\n}\n\n/**\n * Multi-branch conditional rendering. Evaluates each `Match` child in order,\n * renders the first whose `when()` is truthy, or `fallback` if none match.\n *\n * @example\n * h(Switch, { fallback: h(\"p\", null, \"404\") },\n *   h(Match, { when: () => route() === \"/\" }, h(Home, null)),\n *   h(Match, { when: () => route() === \"/about\" }, h(About, null)),\n * )\n */\nfunction isMatchVNode(branch: VNodeChild): branch is VNode {\n  return (\n    branch !== null &&\n    typeof branch === \"object\" &&\n    !Array.isArray(branch) &&\n    (branch as VNode).type === Match\n  )\n}\n\nfunction resolveMatchChildren(matchVNode: VNode): VNodeChildAtom {\n  if (matchVNode.children.length === 0) {\n    return ((matchVNode.props as unknown as MatchProps).children ?? null) as VNodeChildAtom\n  }\n  if (matchVNode.children.length === 1) return matchVNode.children[0] as VNodeChildAtom\n  return matchVNode.children as unknown as VNodeChildAtom\n}\n\nfunction normalizeBranches(children: SwitchProps[\"children\"]): VNodeChild[] {\n  if (Array.isArray(children)) return children\n  if (children != null) return [children]\n  return []\n}\n\nexport function Switch(props: SwitchProps): VNode | null {\n  // Returns a reactive accessor; the renderer unwraps it at mount time.\n  return ((): VNodeChildAtom => {\n    const branches = normalizeBranches(props.children)\n\n    for (const branch of branches) {\n      if (!isMatchVNode(branch)) continue\n      const matchProps = branch.props as unknown as MatchProps\n      if (matchProps.when()) return resolveMatchChildren(branch)\n    }\n\n    return (props.fallback ?? null) as VNodeChildAtom\n  }) as unknown as VNode\n}\n\n// Keep MatchSymbol export for any code that was using it\nexport const MatchSymbol: unique symbol = Symbol(\"pyreon.Match\")\n","import { Fragment, h } from \"./h\"\nimport type { Props, VNode, VNodeChild } from \"./types\"\n\n/** Internal marker attached to lazy()-wrapped components */\nexport type LazyComponent<P extends Props = Props> = ((props: P) => VNode | null) & {\n  __loading: () => boolean\n}\n\n/**\n * Suspense — shows `fallback` while a lazy child component is still loading.\n *\n * Works in tandem with `lazy()` from `@pyreon/react-compat` (or `@pyreon/core/lazy`).\n * The child VNode's `.type.__loading()` signal drives the switch.\n *\n * Usage:\n *   const Page = lazy(() => import(\"./Page\"))\n *\n *   h(Suspense, { fallback: h(Spinner, null) }, h(Page, null))\n *   // or with JSX:\n *   <Suspense fallback={<Spinner />}><Page /></Suspense>\n */\nexport function Suspense(props: { fallback: VNodeChild; children?: VNodeChild }): VNode {\n  return h(Fragment, null, () => {\n    const ch = props.children\n    const childNode = typeof ch === \"function\" ? ch() : ch\n\n    // Check if the child is a VNode whose type is a lazy component still loading\n    const isLoading =\n      childNode != null &&\n      typeof childNode === \"object\" &&\n      !Array.isArray(childNode) &&\n      typeof (childNode as VNode).type === \"function\" &&\n      ((childNode as VNode).type as unknown as LazyComponent).__loading?.()\n\n    if (isLoading) {\n      const fb = props.fallback\n      return typeof fb === \"function\" ? fb() : fb\n    }\n    return childNode\n  })\n}\n"],"mappings":"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"}

package/lib/types/index.d.ts

@@ -175,7 +175,12 @@ declare const Fragment: unique symbol;
  */
 /** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */
 declare const EMPTY_PROPS: Props;
-declare function h<P extends Props>(type: string | ComponentFn<P> | symbol, props: P | null, ...children: VNodeChild[]): VNode;
+/** Makes `children` optional in P (if present) so it can be passed as rest args to h(). */
+type PropsWithOptionalChildren<P extends Props> = Omit<P, "children"> & ("children" extends keyof P ? {
+  children?: P["children"];
+} : unknown);
+declare function h<P extends Props>(type: ComponentFn<P>, props: (PropsWithOptionalChildren<P> & Props) | null, ...children: VNodeChild[]): VNode;
+declare function h(type: string | ((props: any) => VNode | null) | symbol, props: Props | null, ...children: VNodeChild[]): VNode;
 //#endregion
 //#region src/suspense.d.ts
 /** Internal marker attached to lazy()-wrapped components */

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/types.ts","../../src/component.ts","../../src/context.ts","../../src/dynamic.ts","../../src/error-boundary.ts","../../src/for.ts","../../src/h.ts","../../src/suspense.ts","../../src/lazy.ts","../../src/lifecycle.ts","../../src/map-array.ts","../../src/portal.ts","../../src/ref.ts","../../src/show.ts","../../src/telemetry.ts"],"mappings":"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"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/types.ts","../../src/component.ts","../../src/context.ts","../../src/dynamic.ts","../../src/error-boundary.ts","../../src/for.ts","../../src/h.ts","../../src/suspense.ts","../../src/lazy.ts","../../src/lifecycle.ts","../../src/map-array.ts","../../src/portal.ts","../../src/ref.ts","../../src/show.ts","../../src/telemetry.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Core component model and lifecycle for Pyreon",
   "license": "MIT",
   "repository": {
@@ -49,7 +49,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@pyreon/reactivity": "^0.3.0"
+    "@pyreon/reactivity": "^0.3.1"
   },
   "publishConfig": {
     "access": "public"

package/src/env.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Minimal process type — just enough for `process.env.NODE_ENV` checks.
+ * Avoids requiring @types/node in consumers that import pyreon source
+ * via the `"bun"` export condition.
+ */
+declare var process: { env: { NODE_ENV?: string } }

package/src/h.ts

@@ -13,6 +13,24 @@ export const Fragment: unique symbol = Symbol("Pyreon.Fragment")
 /** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */
 export const EMPTY_PROPS: Props = {} as Props
 
+/** Makes `children` optional in P (if present) so it can be passed as rest args to h(). */
+type PropsWithOptionalChildren<P extends Props> = Omit<P, "children"> &
+  ("children" extends keyof P ? { children?: P["children"] } : unknown)
+
+// Overload: component with typed props — children is optional in the props object
+// because it can be passed as rest args. Extra keys are allowed via `& Props`.
+export function h<P extends Props>(
+  type: ComponentFn<P>,
+  props: (PropsWithOptionalChildren<P> & Props) | null,
+  ...children: VNodeChild[]
+): VNode
+// Overload: intrinsic element, symbol, generic/dynamic component, or mixed union
+// biome-ignore lint/suspicious/noExplicitAny: accepts any component function for generic components like For<T>
+export function h(
+  type: string | ((props: any) => VNode | null) | symbol,
+  props: Props | null,
+  ...children: VNodeChild[]
+): VNode
 export function h<P extends Props>(
   type: string | ComponentFn<P> | symbol,
   props: P | null,