@pyreon/vue-compat 0.2.1 → 0.3.0

package/lib/types/index2.d.ts

@@ -11,14 +11,12 @@ interface Ref<T = unknown> {
  * Creates a reactive ref wrapping the given value.
  * Access via `.value` — reads track, writes trigger.
  *
- * Difference from Vue: backed by a Pyreon signal. No `__v_isShallow` distinction
- * at runtime since Pyreon signals are always shallow (deep reactivity is via stores).
+ * Inside a component: hook-indexed. The setter also calls `scheduleRerender()`.
+ * Outside a component: creates a standalone reactive ref.
  */
 declare function ref<T>(value: T): Ref<T>;
 /**
  * Creates a shallow ref — same as `ref()` in Pyreon since signals are inherently shallow.
- *
- * Difference from Vue: identical to `ref()` — Pyreon signals don't perform deep conversion.
  */
 declare function shallowRef<T>(value: T): Ref<T>;
 /**
@@ -40,11 +38,9 @@ interface WritableComputedRef<T = unknown> extends Ref<T> {
   value: T;
 }
 /**
- * Creates a computed ref. Supports both readonly and writable forms:
- *   - `computed(() => value)` — readonly ComputedRef
- *   - `computed({ get, set })` — writable WritableComputedRef
+ * Creates a computed ref. Supports both readonly and writable forms.
  *
- * Backed by Pyreon's `computed()`, wrapped in a `.value` accessor.
+ * Inside a component: hook-indexed.
  */
 declare function computed<T>(getter: () => T): ComputedRef<T>;
 declare function computed<T>(options: {
@@ -55,39 +51,36 @@ declare function computed<T>(options: {
  * Creates a deeply reactive proxy from a plain object.
  * Backed by Pyreon's `createStore()`.
  *
- * Difference from Vue: uses Pyreon's fine-grained per-property signals.
- * Direct mutation triggers only affected signals.
+ * Inside a component: hook-indexed. Proxy wrapper intercepts sets to
+ * call `scheduleRerender()`.
  */
 declare function reactive<T extends object>(obj: T): T;
 /**
- * Creates a shallow reactive proxy.
- * In Pyreon, `createStore` is already per-property (not deeply recursive for primitives),
- * but nested objects will be wrapped. For truly shallow behavior, use individual refs.
- *
- * Difference from Vue: backed by `createStore()` — same as `reactive()` in practice.
+ * Creates a shallow reactive proxy — same as `reactive()` in Pyreon.
  */
 declare function shallowReactive<T extends object>(obj: T): T;
 /**
  * Returns a readonly proxy that throws on mutation attempts.
  *
- * Difference from Vue: uses a simple Proxy with a set trap that throws,
- * rather than Vue's full readonly reactive system.
+ * Inside a component: hook-indexed.
  */
 declare function readonly<T extends object>(obj: T): Readonly<T>;
 /**
  * Returns the raw (unwrapped) object behind a reactive or readonly proxy.
- *
- * Difference from Vue: only works for objects created via `reactive()` or `readonly()`.
  */
 declare function toRaw<T extends object>(proxy: T): T;
 /**
  * Creates a ref linked to a property of a reactive object.
  * Reading/writing the ref's `.value` reads/writes the original property.
+ *
+ * Inside a component: hook-indexed.
  */
 declare function toRef<T extends object, K extends keyof T>(obj: T, key: K): Ref<T[K]>;
 /**
  * Converts all properties of a reactive object into individual refs.
  * Each ref is linked to the original property (not a copy).
+ *
+ * Inside a component: hook-indexed (the entire result, not individual refs).
  */
 declare function toRefs<T extends object>(obj: T): { [K in keyof T]: Ref<T[K]> };
 interface WatchOptions {
@@ -99,68 +92,54 @@ interface WatchOptions {
 type WatchSource<T> = Ref<T> | (() => T);
 /**
  * Watches a reactive source and calls `cb` when it changes.
- * Tracks old and new values.
  *
- * Difference from Vue: `deep` option is ignored — Pyreon tracks dependencies automatically.
- * Returns a stop function to dispose the watcher.
+ * Inside a component: hook-indexed, created once. Disposed on unmount.
  */
 declare function watch<T>(source: WatchSource<T>, cb: (newValue: T, oldValue: T | undefined) => void, options?: WatchOptions): () => void;
 /**
  * Runs the given function reactively — re-executes whenever its tracked
  * dependencies change.
  *
- * Difference from Vue: identical to Pyreon's `effect()`.
- * Returns a stop function.
+ * Inside a component: hook-indexed, created once. Disposed on unmount.
  */
 declare function watchEffect(fn: () => void): () => void;
 /**
  * Registers a callback to run after the component is mounted.
- *
- * Difference from Vue: maps directly to Pyreon's `onMount()`.
- * In Pyreon there is no distinction between beforeMount and mounted.
+ * Hook-indexed: only registered on first render.
  */
 declare function onMounted(fn: () => void): void;
 /**
- * Registers a callback to run before the component is unmounted.
- *
- * Difference from Vue: maps to Pyreon's `onUnmount()`.
- * In Pyreon there is no distinction between beforeUnmount and unmounted.
+ * Registers a callback to run when the component is unmounted.
+ * Hook-indexed: only registered on first render.
  */
 declare function onUnmounted(fn: () => void): void;
 /**
- * Registers a callback to run after a reactive update.
- *
- * Difference from Vue: maps to Pyreon's `onUpdate()`.
+ * Registers a callback to run after a reactive update (not on initial mount).
+ * Hook-indexed: registered once, fires on each re-render.
  */
 declare function onUpdated(fn: () => void): void;
 /**
  * Registers a callback to run before mount.
- * In Pyreon there is no pre-mount phase — maps to `onMount()`.
+ * In Pyreon there is no pre-mount phase — maps to `onMounted()`.
  */
 declare function onBeforeMount(fn: () => void): void;
 /**
  * Registers a callback to run before unmount.
- * In Pyreon there is no pre-unmount phase — maps to `onUnmount()`.
+ * In Pyreon there is no pre-unmount phase — maps to `onUnmounted()`.
  */
 declare function onBeforeUnmount(fn: () => void): void;
 /**
  * Returns a Promise that resolves after all pending reactive updates have flushed.
- *
- * Difference from Vue: identical to Pyreon's `nextTick()`.
  */
 declare function nextTick(): Promise<void>;
 /**
  * Provides a value to all descendant components.
  *
- * Difference from Vue: backed by Pyreon's context stack (pushContext/popContext).
- * Must be called during component setup. The value is scoped to the component
- * tree — not globally shared.
+ * Inside a component: hook-indexed, pushed once. Popped on unmount.
  */
 declare function provide<T>(key: string | symbol, value: T): void;
 /**
  * Injects a value provided by an ancestor component.
- *
- * Difference from Vue: backed by Pyreon's context system (useContext).
  */
 declare function inject<T>(key: string | symbol, defaultValue?: T): T | undefined;
 interface ComponentOptions<P extends Props = Props> {
@@ -172,9 +151,6 @@ interface ComponentOptions<P extends Props = Props> {
 /**
  * Defines a component using Vue 3 Composition API style.
  * Only supports the `setup()` function — Options API is not supported.
- *
- * Difference from Vue: returns a Pyreon `ComponentFn`. No template/render option —
- * the setup function should return a render function or VNode directly.
  */
 declare function defineComponent<P extends Props = Props>(options: ComponentOptions<P> | ((props: P) => VNodeChild)): ComponentFn<P>;
 interface App {
@@ -183,9 +159,6 @@ interface App {
 }
 /**
  * Creates a Pyreon application instance — Vue 3 `createApp()` compatible.
- *
- * Difference from Vue: does not support plugins, directives, or global config.
- * The component receives `props` if provided.
  */
 declare function createApp(component: ComponentFn, props?: Props): App;
 //#endregion

package/lib/types/index2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/vue-compat",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Vue 3-compatible Composition API shim for Pyreon — write Vue-style code that runs on Pyreon's reactive engine",
   "license": "MIT",
   "repository": {
@@ -28,6 +28,16 @@
       "bun": "./src/index.ts",
       "import": "./lib/index.js",
       "types": "./lib/types/index.d.ts"
+    },
+    "./jsx-runtime": {
+      "bun": "./src/jsx-runtime.ts",
+      "import": "./lib/jsx-runtime.js",
+      "types": "./lib/types/jsx-runtime.d.ts"
+    },
+    "./jsx-dev-runtime": {
+      "bun": "./src/jsx-runtime.ts",
+      "import": "./lib/jsx-runtime.js",
+      "types": "./lib/types/jsx-runtime.d.ts"
     }
   },
   "scripts": {
@@ -39,9 +49,9 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@pyreon/core": "^0.2.1",
-    "@pyreon/reactivity": "^0.2.1",
-    "@pyreon/runtime-dom": "^0.2.1"
+    "@pyreon/core": "^0.3.0",
+    "@pyreon/reactivity": "^0.3.0",
+    "@pyreon/runtime-dom": "^0.3.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.3",