feat: makes interface more ssr safe

Author: thedanchez

README.md

@@ -4,11 +4,12 @@
 
 [![NPM Version](https://img.shields.io/npm/v/@dschz/solid-create-script.svg?style=for-the-badge)](https://www.npmjs.com/package/@dschz/solid-create-script)
 [![Build Status](https://img.shields.io/github/actions/workflow/status/dsnchz/solid-create-script/ci.yaml?branch=main&logo=github&style=for-the-badge)](https://github.com/dsnchz/solid-create-script/actions/workflows/ci.yaml)
-[![bun](https://img.shields.io/badge/maintained%20with-bun-cc00ff.svg?style=for-the-badge&logo=bun)](https://bun.sh/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-supported-blue?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
+[![SSR Compatible](https://img.shields.io/badge/SSR-compatible-brightgreen?style=for-the-badge)](#)
 
 # @dschz/solid-create-script
 
-> SolidJS hook to declaratively load external scripts, built on top of [`@dschz/load-script`](https://www.npmjs.com/package/@dschz/load-script).
+> SolidJS hook to load external scripts -- built on top of [`@dschz/load-script`](https://www.npmjs.com/package/@dschz/load-script).
 
 ## ✅ Features
 
@@ -20,11 +21,8 @@
 
 ```bash
 npm install solid-js @dschz/load-script @dschz/solid-create-script
-
 pnpm install solid-js @dschz/load-script @dschz/solid-create-script
-
 yarn install solid-js @dschz/load-script @dschz/solid-create-script
-
 bun install solid-js @dschz/load-script @dschz/solid-create-script
 ```
 
@@ -37,15 +35,15 @@ bun install solid-js @dschz/load-script @dschz/solid-create-script
 
 ### `createScript(src, options?, container?)`
 
-Wraps `loadScript` in a `createResource()` to enable declarative async tracking inside SolidJS.
+Loads an external script dynamically and returns a `Resource<HTMLScriptElement>`.
 
 #### Parameters:
 
-- `src` _(string)_: the script source to download
-- `options` _(LoadScriptOptions)_: standard script attributes (e.g. `async`, `type`, `nonce`, etc.)
-- `container` _(HTMLElement)_: DOM node to append the script to (defaults to `document.head`)
-
-Returns a Solid `Resource<HTMLScriptElement>`.
+| Name        | Type                | Description                                                       |
+| ----------- | ------------------- | ----------------------------------------------------------------- |
+| `src`       | `string`            | Script URL (required)                                             |
+| `options`   | `LoadScriptOptions` | `loadScript` options (e.g. `async`, `type`)                       |
+| `container` | `HTMLElement`       | HTML element to append `<script />` to (default: `document.head`) |
 
 ## 🧪 Example
 
@@ -70,7 +68,7 @@ const CustomComponent = () => {
 
 - Scripts are cached by `src` unless `innerHTML` or `textContent` is used
 - Scripts are not automatically removed on cleanup/unmount
-- Designed to be simple and safe to use inside SolidJS components
+- Designed to be simple and safe to use inside SolidJS components (in SSR and non-SSR environments)
 
 ## 💬 Feedback & Contributions
 

bun.lock

@@ -5,7 +5,7 @@
       "name": "solid-create-script",
       "devDependencies": {
         "@changesets/cli": "^2.29.3",
-        "@dschz/load-script": "^1.0.5",
+        "@dschz/load-script": "^1.0.7",
         "@solidjs/testing-library": "^0.8.10",
         "@testing-library/jest-dom": "^6.6.3",
         "@types/bun": "^1.2.12",
@@ -26,7 +26,7 @@
         "vitest": "^2.1.9",
       },
       "peerDependencies": {
-        "@dschz/load-script": ">=1.0.4",
+        "@dschz/load-script": ">=1.0.7",
         "solid-js": ">=1.6.0",
       },
     },
@@ -138,7 +138,7 @@
 
     "@csstools/css-tokenizer": ["@csstools/css-tokenizer@3.0.3", "", {}, "sha512-UJnjoFsmxfKUdNYdWgOB0mWUypuLvAfQPH1+pyvRJs6euowbFkFC6P13w1l8mJyi3vxYMxc9kld5jZEGRQs6bw=="],
 
-    "@dschz/load-script": ["@dschz/load-script@1.0.4", "", {}, "sha512-6XHrWt/HbQilI1CsA6HUVJ13R0TDNSpS/LrzEJS+6SARbc/37tMCEOOG4d0MLbsdmll0XhodEky7gJjC7+khRw=="],
+    "@dschz/load-script": ["@dschz/load-script@1.0.7", "", {}, "sha512-nFuw/D3W7kyrHlQ4TVTwNvx8w5w6IAID0u5RrkJxaAZ5aDa1AHKKdMwEXhrU31x7rQSRfQLqx+yaOolvjPB3Og=="],
 
     "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.25.4", "", { "os": "aix", "cpu": "ppc64" }, "sha512-1VCICWypeQKhVbE9oW/sJaAmjLxhVqacdkvPLEjwlttjfwENRSClS8EjBz0KzRyFSCPDIkuXW34Je/vk7zdB7Q=="],
 

package.json

@@ -66,7 +66,7 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.3",
-    "@dschz/load-script": "^1.0.5",
+    "@dschz/load-script": "^1.0.7",
     "@solidjs/testing-library": "^0.8.10",
     "@testing-library/jest-dom": "^6.6.3",
     "@types/bun": "^1.2.12",
@@ -87,7 +87,7 @@
     "vitest": "^2.1.9"
   },
   "peerDependencies": {
-    "@dschz/load-script": ">=1.0.4",
+    "@dschz/load-script": ">=1.0.7",
     "solid-js": ">=1.6.0"
   }
 }

src/createScript.tsx

@@ -25,14 +25,14 @@ import { createResource, type Resource } from "solid-js";
  *
  * @param src - The script URL to load.
  * @param options - HTML script attributes (e.g. async, type, innerHTML).
- * @param container - The HTMLElement to append the `<script />` to.
- * @returns A SolidJS `Resource<HTMLScriptElement>` representing the loading state.
+ * @param container - The HTMLElement to append the `<script />` to (defaults to `document.head`).
+ * @returns `Resource<HTMLScriptElement>`
  */
 export const createScript = (
   src: string,
   options: LoadScriptOptions = {},
-  target: HTMLElement | null = document.head,
+  container?: HTMLElement | null,
 ): Resource<HTMLScriptElement> => {
-  const [script] = createResource(() => loadScript(src, options, target));
+  const [script] = createResource(() => loadScript(src, options, container));
   return script;
 };