vertz 0.2.76 → 0.2.80

package/CHANGELOG.md

@@ -1,5 +1,176 @@
 # vertz
 
+## 0.2.80
+
+### Patch Changes
+
+- [#2965](https://github.com/vertz-dev/vertz/pull/2965) [`06605b0`](https://github.com/vertz-dev/vertz/commit/06605b0ac447d3a3acf55e639a8173992c1d3a2c) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - fix(compiler): disambiguate context stable ids when two `createContext` calls share a variable name in the same file
+
+  Closes [#2786](https://github.com/vertz-dev/vertz/issues/2786).
+
+  `injectContextStableIds` generated the id as `{filePath}::{varName}`. Two `createContext()` calls in the same file with the same variable name (e.g. an inlined/formatted pair on one line, or a code-generated module) produced the same id, so the runtime context registry silently returned the same object for both — breaking Provider/useContext pairing.
+
+  Both the Rust transform (`native/vertz-compiler-core/src/context_stable_ids.rs`) and the TypeScript sibling (`packages/ui-server/src/build-plugin/context-stable-ids.ts`) now track a per-name occurrence counter and suffix `@N` on repeats. The first occurrence of a name keeps the original `{filePath}::{varName}` id (so existing single-context files are unchanged); the second becomes `{filePath}::{varName}@1`, the third `@2`, and so on.
+
+  A per-name counter is used rather than a source span because counters only shift when contexts are added or removed, whereas spans shift on any edit to earlier code — counters are more HMR-stable.
+
+- [#2938](https://github.com/vertz-dev/vertz/pull/2938) [`682eb30`](https://github.com/vertz-dev/vertz/commit/682eb3067dbc11cfc09f882debaea9575edca4fe) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - fix(compiler): AOT threads hydration id onto the first element child of a fragment root
+
+  Closes [#2784](https://github.com/vertz-dev/vertz/issues/2784).
+
+  Previously, when an interactive component (a component with a `let` declaration) returned a JSX fragment, the AOT SSR transformer silently dropped the `data-v-id` marker. `fragment_to_string` took no `hydration_id` parameter, and the call site in `expr_to_string` passed the id into `element_to_string` but not into `fragment_to_string`. Result: the server-rendered HTML had no root marker the client hydrator could locate, so event handlers and signal subscriptions never attached — an invisible failure for any component written as `return <>...</>`.
+
+  The AOT path now matches the runtime SSR behavior (where `inject_hydration_attr` already skips `document.createDocumentFragment()` and targets the first `__element(...)` call): the hydration id is threaded into `fragment_to_string`, and gets attached to the first element-or-fragment child. Text and expression children are skipped; nested fragments recurse, carrying the id down until an element is found or the fragment is exhausted.
+
+- [#3019](https://github.com/vertz-dev/vertz/pull/3019) [`3accbd6`](https://github.com/vertz-dev/vertz/commit/3accbd6115a695beb58375b9c2d6031132f84549) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - fix(compiler): use span-overlap (not point) check for mutation ranges in signal transformer
+
+  Closes [#2785](https://github.com/vertz-dev/vertz/issues/2785).
+
+  `is_in_mutation_range` tested whether `ident.span.start` was a member of a recorded mutation range (`pos >= start && pos < end`). That contract relied on `mutation_analyzer` always recording a span that begins exactly at the identifier's first character — so any future tightening (e.g., the operator-only span for `+=`, or a span recorded on an inner sub-expression) would silently misclassify the identifier as outside the range and double-handle it by appending `.value` on top of the mutation rewrite.
+
+  Replaced the point check with a span-overlap check (`ident.start < range.end && ident.end > range.start`), renamed the predicate to `overlaps_mutation_range`, and applied it at all three call sites: identifier reads, assignment-expression LHS, and update-expression targets.
+
+- [#2991](https://github.com/vertz-dev/vertz/pull/2991) [`27ea038`](https://github.com/vertz-dev/vertz/commit/27ea038885c372ff6c448d0b1dfff71e0f4e4f21) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - fix(compiler): make early-return guards reactive in component bodies
+
+  Closes [#2987](https://github.com/vertz-dev/vertz/issues/2987).
+
+  A component of the shape `if (cond) return <Loading/>; return <Ready/>;` froze at the guard branch: the body ran once at mount and never re-ran when `cond` flipped. This broke the documented loading-UX pattern of `query().loading` + early return.
+
+  The compiler now detects the guard shape (N consecutive `if (cond) return <jsx>;` at the top of a component body, followed by a single trailing `return <jsx>;`) and rewrites the body to wrap the main return in a chain of `__conditional(() => cond, () => branch, () => fallback)` calls, so the condition is re-evaluated reactively and the DOM swaps between branches without re-mounting the component.
+
+  Guards with an `else` branch, multi-statement blocks, or non-guard statements between guards are left alone — the per-return mount-frame wrapper still handles them.
+
+- [#2955](https://github.com/vertz-dev/vertz/pull/2955) [`2c1616c`](https://github.com/vertz-dev/vertz/commit/2c1616cbfea5fe43d6fea063cd849dee072452fc) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - feat(client): type `import.meta.main` in `vertz/client` and `@vertz/ui/client`
+
+  Closes [#2811](https://github.com/vertz-dev/vertz/issues/2811).
+
+  Follow-up to #2777. The vtz runtime (via deno_core) already sets `import.meta.main` on every module — `true` for the entry module, `false` for imported modules — so the standard "run if main" idiom works without any polyfill:
+
+  ```ts
+  // src/api/server.ts
+  const app = createServer({
+    /* ... */
+  });
+  export default app;
+
+  if (import.meta.main) app.listen(env.PORT);
+  ```
+
+  Previously the type was only available to projects that pulled in `bun-types`. The client augmentation (`packages/ui/client.d.ts`) now declares `readonly main: boolean` alongside `hot`, so any tsconfig that includes `"types": ["vertz/client"]` (or `"@vertz/ui/client"`) gets it automatically. Scaffolded apps already have this entry.
+
+  `bun-types` removed from `sites/dev-orchestrator` where it was only kept for this type.
+
+- Updated dependencies [[`06605b0`](https://github.com/vertz-dev/vertz/commit/06605b0ac447d3a3acf55e639a8173992c1d3a2c), [`4855184`](https://github.com/vertz-dev/vertz/commit/485518401f703a3d7bd7a57199f548e83c1c16c9), [`513fe1e`](https://github.com/vertz-dev/vertz/commit/513fe1efdb84d9e1f71ade7bf3fe3b0ad34b7086), [`2840af4`](https://github.com/vertz-dev/vertz/commit/2840af4be81a3e9479cad8e9d65577c812b1490f), [`5b3838b`](https://github.com/vertz-dev/vertz/commit/5b3838b4cebf4e7436e8dee6c40d55ddb1d456fc), [`f426ce5`](https://github.com/vertz-dev/vertz/commit/f426ce57a57e7c23e84873250a94e9810ddcaeed), [`85707b2`](https://github.com/vertz-dev/vertz/commit/85707b2c90ed6022eb52075f791796b44d242f2c), [`2c1616c`](https://github.com/vertz-dev/vertz/commit/2c1616cbfea5fe43d6fea063cd849dee072452fc), [`e84adde`](https://github.com/vertz-dev/vertz/commit/e84adde7b0d46e554627e5c5c408309e2fa6d122)]:
+  - @vertz/ui-server@0.2.80
+  - @vertz/ui@0.2.80
+  - @vertz/schema@0.2.80
+  - @vertz/fetch@0.2.80
+  - @vertz/server@0.2.80
+  - @vertz/cli@0.2.80
+  - @vertz/cloudflare@0.2.80
+  - @vertz/db@0.2.80
+  - @vertz/errors@0.2.80
+  - @vertz/testing@0.2.80
+  - @vertz/tui@0.2.80
+  - @vertz/ui-auth@0.2.80
+  - @vertz/ui-primitives@0.2.80
+
+## 0.2.79
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @vertz/cli@0.2.79
+  - @vertz/cloudflare@0.2.79
+  - @vertz/db@0.2.79
+  - @vertz/errors@0.2.79
+  - @vertz/fetch@0.2.79
+  - @vertz/schema@0.2.79
+  - @vertz/server@0.2.79
+  - @vertz/testing@0.2.79
+  - @vertz/tui@0.2.79
+  - @vertz/ui@0.2.79
+  - @vertz/ui-primitives@0.2.79
+  - @vertz/ui-server@0.2.79
+  - @vertz/ui-auth@0.2.20
+
+## 0.2.78
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @vertz/cli@0.2.78
+  - @vertz/cloudflare@0.2.78
+  - @vertz/db@0.2.78
+  - @vertz/errors@0.2.78
+  - @vertz/fetch@0.2.78
+  - @vertz/schema@0.2.78
+  - @vertz/server@0.2.78
+  - @vertz/testing@0.2.78
+  - @vertz/tui@0.2.78
+  - @vertz/ui@0.2.78
+  - @vertz/ui-primitives@0.2.78
+  - @vertz/ui-server@0.2.78
+  - @vertz/ui-auth@0.2.20
+
+## 0.2.77
+
+### Patch Changes
+
+- [#2895](https://github.com/vertz-dev/vertz/pull/2895) [`368e138`](https://github.com/vertz-dev/vertz/commit/368e1382421dbbb78e02a6766143a38bce696d76) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - fix(vertz): auto-load `import.meta.hot` types when importing from any client-runtime subpath
+
+  Closes [#2893](https://github.com/vertz-dev/vertz/issues/2893).
+
+  The `vertz/client` type augmentation existed but required users to manually add `"types": ["vertz/client"]` to their tsconfig — a step easy to miss, leading to the TS2339 "Property 'hot' does not exist on type 'ImportMeta'" error reported in #2777 and then again in #2893.
+
+  The client-runtime subpath declarations (`dist/ui.d.ts`, `dist/ui-components.d.ts`, `dist/ui-primitives.d.ts`, `dist/ui-auth.d.ts`) now start with `/// <reference types="vertz/client" />`, injected by a post-`tsc` step (`scripts/inject-client-reference.mjs`). Any file that imports from one of those subpaths — which includes every `create-vertz-app` scaffold's `entry-client.ts` — pulls in the `ImportMeta.hot` augmentation automatically, so `import.meta.hot?.accept()` typechecks with no tsconfig changes. Declaration sourcemaps are shifted by one line to stay accurate.
+
+  The `"types": ["vertz/client"]` opt-in still works for cases where a file uses `import.meta.hot` without touching any of those subpaths.
+
+- [#2917](https://github.com/vertz-dev/vertz/pull/2917) [`abffcd7`](https://github.com/vertz-dev/vertz/commit/abffcd7af0ec4e7ca134b9bee371c7d2d32858ff) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - feat(vertz): add `invalidate`, `decline`, `on`, `off` to `import.meta.hot`
+
+  Closes [#2812](https://github.com/vertz-dev/vertz/issues/2812).
+
+  The `vtz` compiler previously stripped `import.meta.hot` references entirely at build time, so calls to `accept()` / `dispose()` were no-ops under `vtz dev`. The compiler now rewrites `import.meta.hot` to a runtime lookup (`globalThis.__vtz_hot?.(import.meta.url)`) that resolves to a real per-module hot context exposed by the HMR client.
+
+  New methods on `ImportMetaHot`:
+
+  - `invalidate(message?)` — trigger a full page reload with an optional reason.
+  - `decline()` — opt out of HMR for the current module; the next update targeting it falls back to a full reload.
+  - `on(event, cb)` / `off(event, cb)` — subscribe to runtime events: `vertz:beforeUpdate`, `vertz:afterUpdate`, `vertz:beforeFullReload`, `vertz:invalidate`, `vertz:error`.
+
+  `send()` (custom client → server events) and `prune()` (cleanup on module removal) are tracked as a follow-up — they require bidirectional WebSocket support and module-removal tracking.
+
+- [#2926](https://github.com/vertz-dev/vertz/pull/2926) [`4d9b23d`](https://github.com/vertz-dev/vertz/commit/4d9b23d1cac81ab88388f044d5988b2d0704f363) Thanks [@viniciusdacal](https://github.com/viniciusdacal)! - feat(ui): add `@vertz/ui/client` subpath for UI-only consumers of `import.meta.hot` types [#2813]
+
+  Apps that install `@vertz/ui` directly — component-library authors, or frontends that don't use the server/db layers — can now type `import.meta.hot` without pulling in the `vertz` meta-package:
+
+  ```jsonc
+  // tsconfig.json
+  {
+    "compilerOptions": {
+      "types": ["@vertz/ui/client"]
+    }
+  }
+  ```
+
+  The canonical augmentation now lives in `@vertz/ui/client.d.ts`. `vertz/client` continues to work and resolves to the same shape — it re-exports `@vertz/ui/client` via a triple-slash reference, so the two subpaths cannot drift.
+
+- Updated dependencies [[`81ffffe`](https://github.com/vertz-dev/vertz/commit/81ffffe18b499a18f8b83b5a78079baf40d7cc88), [`13c2ee6`](https://github.com/vertz-dev/vertz/commit/13c2ee6d7804e988e2b361af5c7e9a9c97e091ab), [`6a1adab`](https://github.com/vertz-dev/vertz/commit/6a1adab795218a347c96e831d0628457dd72b796), [`8f5b18b`](https://github.com/vertz-dev/vertz/commit/8f5b18b5d726148bc4613f28d2c752d6e5998f13), [`b7500f9`](https://github.com/vertz-dev/vertz/commit/b7500f9489d7bb65260ec7fff5f95b3fd4d95925), [`846b303`](https://github.com/vertz-dev/vertz/commit/846b303ef2a887208a397b9137cd32675a7dff4e), [`a81fd4f`](https://github.com/vertz-dev/vertz/commit/a81fd4fbd6b540ded6da83abf2d5afe35f7b242a), [`40c8a70`](https://github.com/vertz-dev/vertz/commit/40c8a70693665bf5c0a47bf957923ff57abbc41c), [`cc62c89`](https://github.com/vertz-dev/vertz/commit/cc62c89b5b126bb22a11fe1c1c89088857b3dca2), [`9819901`](https://github.com/vertz-dev/vertz/commit/9819901b97226bbdffb090a7261ee2e3828d163c), [`4d9b23d`](https://github.com/vertz-dev/vertz/commit/4d9b23d1cac81ab88388f044d5988b2d0704f363)]:
+  - @vertz/db@0.2.77
+  - @vertz/ui@0.2.77
+  - @vertz/ui-server@0.2.77
+  - @vertz/schema@0.2.77
+  - @vertz/server@0.2.77
+  - @vertz/cli@0.2.77
+  - @vertz/cloudflare@0.2.77
+  - @vertz/errors@0.2.77
+  - @vertz/fetch@0.2.77
+  - @vertz/testing@0.2.77
+  - @vertz/tui@0.2.77
+  - @vertz/ui-primitives@0.2.77
+  - @vertz/ui-auth@0.2.20
+
 ## 0.2.76
 
 ### Patch Changes

package/client.d.ts

@@ -1,6 +1,12 @@
 /**
  * Vertz client-side runtime type augmentations.
  *
+ * The canonical augmentation lives in `@vertz/ui/client` so that apps which
+ * install `@vertz/ui` directly (without the meta-package) can opt into the
+ * same `ImportMeta.hot` types. This file re-exports it so `vertz/client`
+ * stays a valid tsconfig entry — both subpaths resolve to the same shape
+ * and cannot drift.
+ *
  * Include in your tsconfig.json:
  *   "types": ["vertz/client"]
  *
@@ -8,24 +14,6 @@
  *   /// <reference types="vertz/client" />
  */
 
-declare global {
-  interface ImportMetaHot {
-    /** Accept the current module's HMR update. */
-    accept(): void;
-    /** Accept the current module's HMR update with a callback receiving the new module. */
-    accept(cb: (newModule: unknown) => void): void;
-    /** Accept updates for specific dependencies. */
-    accept(deps: string | readonly string[], cb?: (modules: unknown[]) => void): void;
-    /** Dispose callback — runs before module is replaced. */
-    dispose(cb: (data: Record<string, unknown>) => void): void;
-    /** Persistent data across HMR updates. */
-    data: Record<string, unknown>;
-  }
-
-  interface ImportMeta {
-    /** Hot Module Replacement API. Only available in dev mode; undefined in production and SSR. */
-    readonly hot: ImportMetaHot | undefined;
-  }
-}
+/// <reference types="@vertz/ui/client" />
 
 export {};

package/dist/ui-auth.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="vertz/client" />
 export * from '@vertz/ui-auth';
 //# sourceMappingURL=ui-auth.d.ts.map

package/dist/ui-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-auth.d.ts","sourceRoot":"","sources":["../src/ui-auth.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"ui-auth.d.ts","sourceRoot":"","sources":["../src/ui-auth.ts"],"names":[],"mappings":";AAAA,cAAc,gBAAgB,CAAC"}

package/dist/ui-components.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="vertz/client" />
 export * from '@vertz/ui/components';
 //# sourceMappingURL=ui-components.d.ts.map

package/dist/ui-components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-components.d.ts","sourceRoot":"","sources":["../src/ui-components.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"ui-components.d.ts","sourceRoot":"","sources":["../src/ui-components.ts"],"names":[],"mappings":";AAAA,cAAc,sBAAsB,CAAC"}

package/dist/ui-primitives.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="vertz/client" />
 export * from '@vertz/ui-primitives';
 //# sourceMappingURL=ui-primitives.d.ts.map

package/dist/ui-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-primitives.d.ts","sourceRoot":"","sources":["../src/ui-primitives.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"ui-primitives.d.ts","sourceRoot":"","sources":["../src/ui-primitives.ts"],"names":[],"mappings":";AAAA,cAAc,sBAAsB,CAAC"}

package/dist/ui.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="vertz/client" />
 export * from '@vertz/ui';
 //# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":";AAAA,cAAc,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vertz",
-  "version": "0.2.76",
+  "version": "0.2.80",
   "description": "Full-stack TypeScript framework — database ORM, API server, compiled UI, and custom runtime. One schema drives every layer.",
   "keywords": [
     "ai",
@@ -104,26 +104,27 @@
     "provenance": true
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/inject-client-reference.mjs",
     "typecheck": "tsgo --noEmit -p tsconfig.typecheck.json",
     "test": "vtz test"
   },
   "dependencies": {
-    "@vertz/cli": "^0.2.76",
-    "@vertz/cloudflare": "^0.2.76",
-    "@vertz/db": "^0.2.76",
-    "@vertz/errors": "^0.2.76",
-    "@vertz/fetch": "^0.2.76",
-    "@vertz/schema": "^0.2.76",
-    "@vertz/server": "^0.2.76",
-    "@vertz/testing": "^0.2.76",
-    "@vertz/tui": "^0.2.76",
-    "@vertz/ui": "^0.2.76",
-    "@vertz/ui-auth": "^0.2.20",
-    "@vertz/ui-primitives": "^0.2.76",
-    "@vertz/ui-server": "^0.2.76"
+    "@vertz/cli": "^0.2.80",
+    "@vertz/cloudflare": "^0.2.80",
+    "@vertz/db": "^0.2.80",
+    "@vertz/errors": "^0.2.80",
+    "@vertz/fetch": "^0.2.80",
+    "@vertz/schema": "^0.2.80",
+    "@vertz/server": "^0.2.80",
+    "@vertz/testing": "^0.2.80",
+    "@vertz/tui": "^0.2.80",
+    "@vertz/ui": "^0.2.80",
+    "@vertz/ui-auth": "^0.2.80",
+    "@vertz/ui-primitives": "^0.2.80",
+    "@vertz/ui-server": "^0.2.80"
   },
   "devDependencies": {
-    "@vertz/test": "0.2.76"
+    "@vertz/test": "0.2.80",
+    "typescript": "^5.9.0"
   }
 }