feat: rename core package webjs → @webjs/core for npm publish

The unscoped `webjs` name is already taken on npm (webjs@0.6.1, unrelated
project). Moving to the `@webjs` scope lets us publish `@webjs/core`,
`@webjs/server`, and `@webjs/cli` together.

  * Package name: `webjs` → `@webjs/core`. CLI binary stays `webjs`.
  * All imports migrated: `from 'webjs'` → `from '@webjs/core'`,
    subpaths `'webjs/client-router'` → `'@webjs/core/client-router'`, etc.
  * Import map + builtin set + dev server core resolver updated.
  * publishConfig.access = public, files whitelist, repository,
    homepage, bugs, license, keywords added to each published package.
  * README.md added for @webjs/core, @webjs/server, @webjs/cli.
  * Scaffolded template deps updated (webjs → @webjs/core).
  * Test symlinks updated (node_modules/webjs → node_modules/@webjs/core).
  * Docs, AGENTS.md, examples all rewritten to use the new specifier.
  * Lockfile regenerated.

All 571 unit tests pass.

Author: vivek7405

AGENTS.md

@@ -295,12 +295,12 @@ Every file is a plain ES module. No config required.
 
 ---
 
-## Public API — `webjs`
+## Public API — `@webjs/core`
 
-Import from the bare specifier `'webjs'` (resolved via the injected import map).
+Import from the bare specifier `'@webjs/core'` (resolved via the injected import map).
 
 ```js
-import { html, css, WebComponent, render, renderToString } from 'webjs';
+import { html, css, WebComponent, render, renderToString } from '@webjs/core';
 ```
 
 | Export            | Purpose |
@@ -319,7 +319,7 @@ import { html, css, WebComponent, render, renderToString } from 'webjs';
 | `connectWS(url, handlers)` | Client-side WebSocket with auto-reconnect, JSON parse/stringify, queued sends. |
 | `richFetch<T>(url, init?)` | Client-side fetch that adds `Accept: application/vnd.webjs+json`, encodes plain-object bodies via superjson, and decodes responses with rich types. |
 
-### Directives — `import { … } from 'webjs/directives'`
+### Directives — `import { … } from '@webjs/core/directives'`
 
 webjs follows a **"less is more"** philosophy: only directives that solve
 problems with NO native alternative are included. AI agents don't need
@@ -349,7 +349,7 @@ syntax sugar — they write code that works, not code that looks pretty.
 | Async data in page | `async` page function (just `await`) |
 | Lists without reorder | `${items.map(item => html\`…\`)}` |
 
-### Context Protocol — `import { … } from 'webjs/context'`
+### Context Protocol — `import { … } from '@webjs/core/context'`
 
 Share data across deeply nested components without prop drilling.
 
@@ -362,7 +362,7 @@ Share data across deeply nested components without prop drilling.
 
 **When to use Context (AI hint):** Use when data (theme, auth state, locale, config) must reach components many levels deep without threading it through every intermediate component's attributes. Do NOT use for data that changes on every render (use state for that) or for data that only one component needs (use a server action or prop).
 
-### Task Controller — `import { Task, TaskStatus } from 'webjs/task'`
+### Task Controller — `import { Task, TaskStatus } from '@webjs/core/task'`
 
 Manages async operations (fetch, compute) inside components with automatic loading/error states and AbortController.
 
@@ -447,7 +447,7 @@ TypeScript's class-field initializer doesn't clobber the reactive
 accessor the framework installs via `Object.defineProperty`.
 
 ```ts
-import { WebComponent, html } from 'webjs';
+import { WebComponent, html } from '@webjs/core';
 
 class StudentCard extends WebComponent {
   static properties = { student: { type: Object } };   // runtime: tracked + coerced
@@ -636,7 +636,7 @@ interpolate via `<style>${STYLES.text}</style>`. `ts-lit-plugin` /
 Example (page):
 
 ```ts
-import { html, css } from 'webjs';
+import { html, css } from '@webjs/core';
 
 const STYLES = css`
   .page-dashboard {
@@ -738,7 +738,7 @@ Set `static shadow = true` when:
 
 ```js
 // app/error.ts — root error boundary
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export default function ErrorPage({ error }: { error: Error }) {
   return html`
@@ -757,7 +757,7 @@ A `loading.js` file is the automatic Suspense boundary for its sibling page. The
 
 ```js
 // app/blog/loading.ts — shown while blog pages load
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export default function Loading() {
   return html`
@@ -861,7 +861,7 @@ Supported files: `sitemap.js`, `robots.js`, `manifest.js`, `icon.js`, `apple-ico
 - On the server these modules are imported normally; you can freely use Prisma, `fs`, environment variables, etc.
 - **Expose as REST**: wrap any action with `expose('METHOD /path', fn)` to ALSO make it reachable at a stable REST URL. The same function body powers both callers:
   ```js
-  import { expose } from 'webjs';
+  import { expose } from '@webjs/core';
   export const createPost = expose('POST /api/posts', async ({ title, body }) => { … });
   ```
   When called over HTTP, the adapter merges `{ ...query, ...urlParams, ...jsonBody }` into a single object argument. This is the recommended way to surface a server action to external consumers — no `route.js` wrapper needed.
@@ -988,7 +988,7 @@ no client-side runtime, no diff from writing the classes by hand.
 Scaffold example (`app/_utils/ui.ts`):
 
 ```ts
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 /** `● label` kicker — small caps, accent colour, above headings. */
 export function rubric(label: string, mb: 'sm' | 'md' = 'md') {
@@ -1060,7 +1060,7 @@ the class-prefix rule documented in the Shadow-vs-Light DOM section.
 
 ```js
 // app/about/page.js
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 export default function About() {
   return html`<h1>About</h1><p>…</p>`;
 }
@@ -1070,7 +1070,7 @@ export default function About() {
 
 ```js
 // app/users/[id]/page.js
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 export default async function User({ params }) {
   // use a server action to fetch; never import a DB client directly in a page
   const user = await fetchUser(params.id);
@@ -1132,7 +1132,7 @@ if (!r.success) this.setState({ error: r.error });
 
 ```js
 // components/hello-world.js
-import { WebComponent, html } from 'webjs';
+import { WebComponent, html } from '@webjs/core';
 export class HelloWorld extends WebComponent {
   render() { return html`<p>Hello!</p>`; }
 }
@@ -1305,7 +1305,7 @@ export async function GET() {
 
 ```ts
 // caller — client side
-import { richFetch } from 'webjs';
+import { richFetch } from '@webjs/core';
 const posts = await richFetch<Post[]>('/api/posts');
 // posts[0].createdAt is a Date here (richFetch sends
 // Accept: application/vnd.webjs+json and superjson-parses the response).
@@ -1474,7 +1474,7 @@ and what stays in-memory.
 ### Streaming SSR / Suspense
 
 ```js
-import { html, Suspense } from 'webjs';
+import { html, Suspense } from '@webjs/core';
 
 export default function Page() {
   return html`
@@ -1580,7 +1580,7 @@ then segment-scoped files.
 
 ### Client router — Turbo Drive-style navigation
 
-`import 'webjs/client-router'` enables SPA-style navigation without full page reloads. Intercepts same-origin `<a>` clicks (including inside shadow DOM via `composedPath()`), fetches the target HTML, and swaps DOM content.
+`import '@webjs/core/client-router'` enables SPA-style navigation without full page reloads. Intercepts same-origin `<a>` clicks (including inside shadow DOM via `composedPath()`), fetches the target HTML, and swaps DOM content.
 
 **How it works:**
 1. Fetches the target URL's HTML via `fetch()`.
@@ -1592,7 +1592,7 @@ then segment-scoped files.
 
 **Programmatic navigation:**
 ```js
-import { navigate } from 'webjs/client-router';
+import { navigate } from '@webjs/core/client-router';
 await navigate('/about');                    // push to history
 await navigate('/login', { replace: true }); // replace history entry
 ```
@@ -1686,7 +1686,7 @@ Use `node:test` and `node:assert/strict`. Test server actions, components
 ```ts
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
-import { html, renderToString } from 'webjs';
+import { html, renderToString } from '@webjs/core';
 
 test('component renders heading', async () => {
   const result = await renderToString(html`<h1>Hello</h1>`);

README.md

@@ -68,7 +68,7 @@ CLAUDE.md     # Claude Code quick-reference
 
 ```ts
 // app/page.ts — server-rendered, async data fetching
-import { html, repeat } from 'webjs';
+import { html, repeat } from '@webjs/core';
 import '../components/counter.ts';
 import { listPosts } from '../modules/posts/queries/list-posts.server.ts';
 
@@ -88,7 +88,7 @@ export default async function Home() {
 
 ```ts
 // components/counter.ts — interactive web component, light DOM + Tailwind
-import { WebComponent, html } from 'webjs';
+import { WebComponent, html } from '@webjs/core';
 
 export class Counter extends WebComponent {
   // Light DOM is the default; Tailwind utility classes apply directly.

docs/app/docs/ai-first/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'AI-First Development — webjs' };
 

docs/app/docs/api-routes/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'API Routes — webjs' };
 
@@ -133,7 +133,7 @@ export async function POST(req: Request) {
 
     <h2>richFetch() -- Typed Client Calls</h2>
     <p>On the client side, <code>richFetch()</code> from <code>webjs</code> is a drop-in replacement for <code>fetch()</code> that enables the superjson round trip:</p>
-    <pre>import { richFetch } from 'webjs';
+    <pre>import { richFetch } from '@webjs/core';
 
 // GET with rich types
 const posts = await richFetch('/api/posts');

docs/app/docs/architecture/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'Architecture — webjs' };
 

docs/app/docs/auth/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'Authentication — webjs' };
 

docs/app/docs/authentication/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'Authentication — webjs' };
 

docs/app/docs/backend-only/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'Backend-Only Mode — webjs' };
 
@@ -129,7 +129,7 @@ export default rateLimit({ window: '10s', max: 5 });</pre>
     <p><code>expose()</code> turns a server action into a typed REST endpoint. This is especially useful in backend-only mode because it lets you define your API logic as plain functions with validation, then expose them over HTTP:</p>
     <pre>// actions/users.server.ts
 'use server';
-import { expose } from 'webjs';
+import { expose } from '@webjs/core';
 import { prisma } from '../lib/prisma.ts';
 
 export const listUsers = expose('GET /api/v2/users', async () =&gt; {
@@ -197,7 +197,7 @@ export async function GET() {
   return json(events); // dates stay as Dates for richFetch callers
 }</pre>
     <pre>// Internal client (another webjs app or same-app component)
-import { richFetch } from 'webjs';
+import { richFetch } from '@webjs/core';
 
 const events = await richFetch('/api/events');
 // events[0].createdAt is a real Date object
@@ -285,8 +285,8 @@ fastify.listen({ port: 3000 });</pre>
   },
   "dependencies": {
     "@webjs/cli": "0.1.0",
+    "@webjs/core": "0.1.0",
     "@webjs/server": "0.1.0",
-    "webjs": "0.1.0",
     "@prisma/client": "^6.0.0"
   },
   "devDependencies": {

docs/app/docs/cache/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'Caching — webjs' };
 

docs/app/docs/client-router/page.ts

@@ -1,4 +1,4 @@
-import { html } from 'webjs';
+import { html } from '@webjs/core';
 
 export const metadata = { title: 'Client Router — webjs' };
 
@@ -45,7 +45,7 @@ export default function ClientRouter() {
     <h2>Programmatic navigation</h2>
     <p>Use <code>navigate()</code> instead of <code>location.href = ...</code>:</p>
 
-    <pre>import { navigate } from 'webjs/client-router';
+    <pre>import { navigate } from '@webjs/core/client-router';
 
 // Normal navigation (adds to history)
 await navigate('/about');
@@ -54,7 +54,7 @@ await navigate('/about');
 await navigate('/login', { replace: true });</pre>
 
     <h2>Disabling the router entirely</h2>
-    <pre>import { disableClientRouter } from 'webjs/client-router';
+    <pre>import { disableClientRouter } from '@webjs/core/client-router';
 disableClientRouter();</pre>
 
     <h2>Listening for navigations</h2>