next-live 0.1.0

package/docs/README.md

@@ -0,0 +1,76 @@
+# next-live documentation
+
+Live TSX/JSX evaluation for React, SSR-safe and tuned for the Next.js App Router.
+
+## Guides
+
+| | |
+|---|---|
+| **[1. Getting started](./01-getting-started.md)** | Install, and a working live preview in four steps. |
+| **[2. The module registry](./02-module-registry.md)** | How `import` resolves. The core concept, read this second. |
+| **[3. Sharing libraries with your app](./03-sharing-your-app-libraries.md)** | Your app and your snippets both use the same library. Is that two copies? (No.) |
+| **[4. Scaling to many apps](./04-scaling.md)** | Keeping the bundle small with hundreds of snippets and a large SDK. |
+| **[5. Security](./05-security.md)** | The trust model, and the CSP you need. **Read before deploying.** |
+| **[6. API reference](./06-api-reference.md)** | Every export, prop, and type. |
+| **[7. Troubleshooting](./07-troubleshooting.md)** | Real error messages and their fixes. |
+| **[8. Integration guide](./08-integration-guide.md)** | End-to-end: apps stored in a database, authored in a control panel. |
+| **[9. Snippets that are not components](./09-non-ui-snippets.md)** | Validators, transformers, config, code with no UI. |
+| **[10. Validating stored snippets in CI](./10-validating-in-ci.md)** | Catch an SDK rename breaking stored apps before your users do. |
+
+## Where to start
+
+- **New here?** [Getting started](./01-getting-started.md), then
+  [the module registry](./02-module-registry.md).
+- **Adding this to a real application?** Jump to the
+  [integration guide](./08-integration-guide.md), then try the live
+  **`/apps` shell demo** in the playground repository.
+- **Something is broken?** [Troubleshooting](./07-troubleshooting.md).
+- **About to deploy?** [Security](./05-security.md), it takes ten minutes and
+  covers the one rule that actually protects you.
+
+## Frequently asked
+
+**Does `import` work for any package?**
+Only what you register. There is no npm in the browser, see
+[the module registry](./02-module-registry.md).
+
+**My app already uses the same library. Two copies?**
+No, one instance, which is why a shared store really is shared.
+[Details and the cases that break it](./03-sharing-your-app-libraries.md).
+
+**Do I need `'unsafe-eval'` in production?**
+Yes, but scoped to the routes that run snippets, not your whole app.
+[Security](./05-security.md).
+
+**Will this bloat my bundle?**
+No. A page that only runs snippets pays **16.1 KB** - the editor and its syntax
+highlighter live on a separate entry (`next-live/editor`), and the transpiler is
+a lazily-fetched chunk. Registering modules as loaders keeps your own
+dependencies out of the page too: measured 827 KB → 666 KB.
+[Scaling](./04-scaling.md).
+
+**Are TypeScript types checked?**
+No. They are stripped, not verified -
+[why](./07-troubleshooting.md#my-typescript-errors-are-not-reported).
+
+**Do I need `next/dynamic` with `ssr: false`?**
+No. It is already SSR-safe.
+[How](./01-getting-started.md#ssr-and-hydration).
+
+**Does this require Next.js?**
+No. The library imports only React, it works in Vite, CRA, Remix, or anywhere
+React runs. The name reflects where it was designed, not what it needs.
+
+**Can a snippet export something other than a component?**
+Yes, `useLiveModule` returns raw exports.
+[Non-UI snippets](./09-non-ui-snippets.md).
+
+**How do I know when I break my stored apps?**
+Validate them in CI.
+[Validating in CI](./10-validating-in-ci.md).
+
+**Do React hooks and Tailwind work in snippets?**
+Hooks yes, snippets share your React instance.
+[Troubleshooting: hooks](./07-troubleshooting.md#do-react-hooks-work-in-snippets).
+Tailwind only through registered UI components or an explicit safelist -
+[Module registry: styling](./02-module-registry.md#styling-and-tailwind).

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "next-live",
+  "version": "0.1.0",
+  "description": "Live TSX/JSX evaluation for React \u2014 real ESM imports, a module registry instead of a global scope, and zero hydration mismatches. Works anywhere React runs, SSR-safe and tuned for the Next.js App Router.",
+  "keywords": [
+    "react",
+    "next",
+    "nextjs",
+    "app-router",
+    "live",
+    "react-live",
+    "playground",
+    "sucrase",
+    "jsx",
+    "tsx",
+    "editor",
+    "eval",
+    "ssr",
+    "vite",
+    "live-code",
+    "code-editor",
+    "react-19"
+  ],
+  "license": "MIT",
+  "author": "Khaled Oghli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/khaledOghli/next-live.git",
+    "directory": "packages/next-live"
+  },
+  "homepage": "https://github.com/khaledOghli/next-live#readme",
+  "bugs": {
+    "url": "https://github.com/khaledOghli/next-live/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./editor": {
+      "types": "./dist/editor.d.ts",
+      "import": "./dist/editor.js",
+      "require": "./dist/editor.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "prepublishOnly": "npm run build && npm test",
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsup && node scripts/add-use-client.mjs",
+    "dev": "tsup --watch --onSuccess \"node scripts/add-use-client.mjs\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:node": "vitest run --exclude '**/*.test.tsx'",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "sucrase": "^3.35.1"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-dom": ">=19",
+    "prism-react-renderer": ">=2"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "jsdom": "^30.0.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.0",
+    "prism-react-renderer": "^2.4.1"
+  },
+  "engines": {
+    "node": ">=20.9"
+  },
+  "peerDependenciesMeta": {
+    "prism-react-renderer": {
+      "optional": true
+    }
+  }
+}