@bun-native/solid 0.0.0-stage → 0.33.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bunly contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @bun-native/solid
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+SolidJS renderer for Bun Native desktop windows.
+
+Part of [Bun Native](https://github.com/0xPlayerOne/bun-native), an experimental developer preview. Version 0.33.1 was built from [c56fdd675365](https://github.com/0xPlayerOne/bun-native/tree/c56fdd6753653a10144a4167c1d3dfb3c38a0647) and published from GitHub Actions with npm provenance. Use the Bun revision pinned in that commit's toolchain.json. Start with the [getting-started guide](https://github.com/0xPlayerOne/bun-native/blob/c56fdd6753653a10144a4167c1d3dfb3c38a0647/docs/getting-started.md); `bun-native host install` fetches the matching release host. The license notice is in LICENSE.

package/bun-native-source.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": 1,
+  "commit": "c56fdd6753653a10144a4167c1d3dfb3c38a0647",
+  "tree": "c6e81b3f9d041e11dd0413b5fdd7a50910383854",
+  "files": {
+    "package.json": {
+      "bytes": 2115,
+      "sha256": "caf866d56f3cd7530d5735ecbf62512e9e22526bc44c75a4b48a18c26352c0b8"
+    },
+    "packages/solid/package.json": {
+      "bytes": 310,
+      "sha256": "5da76ecbbb9ba781fc827191b33a42b25ddcfd8ba1838c0256f82ea1c6838b84"
+    },
+    "packages/solid/src/index.ts": {
+      "bytes": 695,
+      "sha256": "88fe2cfc3d59011bb756bb86bfb040e6280feabd1edb33b7cdeecfc524652250"
+    },
+    "packages/solid/src/jsx.ts": {
+      "bytes": 2731,
+      "sha256": "0ea5386e11e9df63541c381d4794fe0edc0e8269158fa3ac6b6739d12f16c729"
+    },
+    "packages/solid/src/mount.ts": {
+      "bytes": 1936,
+      "sha256": "6395762b787d7929cf616b083d91b171df14e756196f33cf8195391049f2ce55"
+    },
+    "packages/solid/src/renderer.ts": {
+      "bytes": 1292,
+      "sha256": "2d1682b885c1dee1953ba09fdf28bf524945654f7c460840c113cc7b00213ab1"
+    },
+    "LICENSE": {
+      "bytes": 1075,
+      "sha256": "86673fb485f12fa9aaa3941dfccc9f69a7f8322f8141d0d5c73db4323de10ac5"
+    }
+  },
+  "toolchain": {
+    "bytes": 3234,
+    "sha256": "9f4d9362cb4cc38c0f4e705295789a0cbfec46ffdd007e0541b9441a7c3003a7"
+  },
+  "dependencyLock": {
+    "bytes": 28357,
+    "sha256": "65e3dbd01be4a1889367690faf1a9c3f08fb31d22dbd273d9bb9f39dd6baa6fb"
+  }
+}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@bun-native/solid",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.33.1",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "src",
+    "LICENSE",
+    "README.md",
+    "bun-native-source.json"
+  ],
+  "engines": {
+    "bun": "1.4.4-canary.1"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./jsx-runtime": "./src/jsx.ts"
+  },
+  "description": "SolidJS renderer for Bun Native desktop windows.",
+  "dependencies": {
+    "@bun-native/core": "0.33.1",
+    "@bun-native/renderer": "0.33.1"
+  },
+  "peerDependencies": {
+    "solid-js": "1.9.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xPlayerOne/bun-native.git",
+    "directory": "packages/solid"
+  },
+  "homepage": "https://github.com/0xPlayerOne/bun-native#readme",
+  "bugs": "https://github.com/0xPlayerOne/bun-native/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/src/index.ts

@@ -0,0 +1,30 @@
+import { renderer } from './renderer.ts'
+
+export { render } from './mount.ts'
+export type { RenderOptions, RenderRoot } from './mount.ts'
+export {
+  focusNode,
+  inputState,
+  registerDropTarget,
+  scrollNodeIntoView,
+  scrollNodeTo,
+} from '@bun-native/renderer'
+export type { RendererNode as SolidNode } from '@bun-native/renderer'
+export type { JSX } from './jsx.ts'
+
+// This is the helper contract emitted by Solid's official universal JSX compiler.
+export const {
+  effect,
+  memo,
+  createComponent,
+  createElement,
+  createTextNode,
+  insertNode,
+  insert,
+  spread,
+  setProp,
+  mergeProps,
+  use,
+} = renderer
+
+export { For, Show, Switch, Match, Index, ErrorBoundary } from 'solid-js'

package/src/jsx.ts

@@ -0,0 +1,67 @@
+import type { Element as NativeElement, InputState } from '@bun-native/core'
+import type { EventHandlers, RendererNode as SolidNode } from '@bun-native/renderer'
+
+export namespace JSX {
+  export type Element = SolidNode | string | number | boolean | null | undefined | Element[]
+  export interface ElementChildrenAttribute {
+    children: unknown
+  }
+  type Base<Kind extends NativeElement['kind']> = EventHandlers & {
+    style?: Extract<NativeElement, { kind: Kind }>['style']
+    ref?: (node: SolidNode) => void
+  }
+  type TextContent = { text?: string; children?: Element }
+  export interface IntrinsicElements {
+    /**
+     * Requires `accessibility_lists_v1` for the accessible members. A list's
+     * `accessibleSetSize` counts every item, mounted or not; an item's
+     * `accessiblePosition` is its 1-based place in that full set.
+     */
+    box: Base<'box'> & { children?: Element } & {
+      accessibleRole?: 'list' | 'list_item'
+      /** Only with `accessibleRole`. */
+      accessibleLabel?: string
+      /** Only on a `list`. */
+      accessibleSetSize?: number
+      /** Only on a `list_item`; 1-based. */
+      accessiblePosition?: number
+      /** Only on a `list_item`. */
+      accessibleSelected?: boolean
+    }
+    text: Base<'text'> &
+      TextContent & {
+        /** Requires `accessibility_lists_v1`: announce the text when it appears and changes. */
+        accessibleLive?: 'polite' | 'assertive'
+      }
+    button: Base<'button'> & TextContent & { disabled?: boolean }
+    input: Base<'input'> & {
+      value?: string | InputState
+      placeholder?: string
+      /** Requires the host's `input_states_v1` capability. */
+      disabled?: boolean
+      /** Requires the host's `input_states_v1` capability. */
+      readOnly?: boolean
+    }
+    /** At most two pane children; the host owns the divider drag and keyboard steps. */
+    split: Base<'split'> & {
+      children?: Element
+      ratio?: number
+      min_size?: number
+      /** Requires `accessibility_v1`: the divider's accessible name. */
+      accessibleLabel?: string
+    }
+    /** Painted above the ordinary tree; only window-anchored overlays may be modal. */
+    overlay: Base<'overlay'> & {
+      children?: Element
+      /** Requires `overlay_keyboard_v1`: focus the first enabled control on open. */
+      autofocus?: boolean
+      /** Requires `overlay_keyboard_v1`: `menu` adds arrow-key roving focus and type-ahead. */
+      navigation?: 'tab' | 'menu'
+      /** Requires `accessibility_v1`: the dialog's accessible name. */
+      accessibleLabel?: string
+    } & (
+        | { anchor?: 'window'; modal?: boolean; surface?: 'layer' }
+        | { anchor: 'parent'; modal?: false; surface?: 'layer' | 'window' }
+      )
+  }
+}

package/src/mount.ts

@@ -0,0 +1,57 @@
+import { NativeStateError, type NativeWindow } from '@bun-native/core'
+import { createRenderRoot, type RenderOptions, type RenderRoot } from '@bun-native/renderer'
+import { catchError, createMemo, createRoot, createSignal } from 'solid-js'
+import type { JSX } from './jsx.ts'
+import { renderer } from './renderer.ts'
+
+export type { RenderOptions, RenderRoot } from '@bun-native/renderer'
+
+function assertReactiveRuntime(): void {
+  let observed = -1
+  createRoot((dispose) => {
+    const [value, set] = createSignal(0)
+    const derived = createMemo(value)
+    set(1)
+    observed = derived()
+    dispose()
+  })
+  if (observed !== 1)
+    throw new Error(
+      'Solid native rendering requires Bun --conditions=browser (reactive Solid exports)'
+    )
+}
+
+/** Mount one Solid owner into an independently disposable native container. */
+export function render(
+  component: () => JSX.Element,
+  window: NativeWindow,
+  options: RenderOptions = {}
+): RenderRoot {
+  if (typeof component !== 'function')
+    throw new NativeStateError('invalid_state', 'Solid render requires a component function')
+  assertReactiveRuntime()
+  return createRenderRoot(
+    window,
+    ({ container, onCleanup, fail }) => {
+      createRoot((dispose) => {
+        onCleanup(dispose)
+        // An error from a later reactive update ends only this root, as in
+        // React, instead of escaping through whichever setter (usually a
+        // native listener) ran it and ending the application. An error while
+        // evaluating the component still rejects `ready` synchronously.
+        let mounted = false
+        let initial: { cause: unknown } | undefined
+        catchError(
+          () => renderer.insert(container, component()),
+          (cause) => {
+            if (mounted) fail(cause)
+            else initial ??= { cause }
+          }
+        )
+        if (initial) throw initial.cause
+        mounted = true
+      })
+    },
+    options
+  )
+}

package/src/renderer.ts

@@ -0,0 +1,33 @@
+import { createRenderer } from 'solid-js/universal'
+import {
+  asNode,
+  createElement,
+  createTextNode,
+  firstChild,
+  insertNode,
+  nextSibling,
+  removeNode,
+  replaceText,
+  setProperty,
+  type ElementTag,
+  type PropertyName,
+  type RendererNode,
+} from '@bun-native/renderer'
+
+export const renderer = createRenderer<RendererNode>({
+  // The compiler hands over JSX tags and names as strings; the renderer rejects
+  // any it does not know with an UnsupportedFeatureError.
+  createElement: (tag) => createElement(tag as ElementTag),
+  createTextNode,
+  isTextNode: (node) => asNode(node).kind === 'text-node',
+  replaceText: (node, value) => replaceText(asNode(node), value),
+  setProperty: (node, name, value) => setProperty(asNode(node), name as PropertyName, value),
+  // The official universal JSX compiler uses null to delimit a trailing
+  // dynamic region. Both absent forms append; every real anchor stays owned.
+  insertNode: (parent, node, anchor) =>
+    insertNode(asNode(parent), asNode(node), anchor == null ? undefined : asNode(anchor)),
+  removeNode: (parent, node) => removeNode(asNode(parent), asNode(node)),
+  getParentNode: (node) => asNode(node).parent,
+  getFirstChild: (node) => firstChild(asNode(node)),
+  getNextSibling: (node) => nextSibling(asNode(node)),
+})