@sigrea/vue 0.3.0 → 0.4.0

package/README.md

@@ -6,7 +6,7 @@
 - **Computed subscriptions.** `useComputed` subscribes to computed values, mirroring Vue's `computed` while tracking through Sigrea scopes.
 - **Deep signal subscriptions.** `useDeepSignal` subscribes to deep signal objects and exposes them as mutable refs with automatic cleanup.
 - **Two-way bindings.** `useMutableSignal` wraps primitive signals as `WritableComputedRef` for two-way bindings like `v-model`.
-- **Molecule lifecycles.** `useMolcule` mounts molecule factories and binds their lifecycles to Vue components.
+- **Molecule lifecycles.** `useMolecule` mounts molecule factories and binds their lifecycles to Vue components.
 
 ## Table of Contents
 
@@ -21,8 +21,9 @@
   - [useComputed](#usecomputed)
   - [useDeepSignal](#usedeepsignal)
   - [useMutableSignal](#usemutablesignal)
-  - [useMolcule](#usemolcule)
+  - [useMolecule](#usemolecule)
 - [Testing](#testing)
+- [Handling Scope Cleanup Errors](#handling-scope-cleanup-errors)
 - [Development](#development)
 - [License](#license)
 
@@ -76,11 +77,11 @@ export const CounterMolecule = molecule((props: { initialCount: number }) => {
 ```vue
 <!-- Counter.vue -->
 <script setup lang="ts">
-import { useMolcule, useSignal } from "@sigrea/vue";
+import { useMolecule, useSignal } from "@sigrea/vue";
 import { CounterMolecule } from "./CounterMolecule";
 
 const props = defineProps<{ initialCount: number }>();
-const counter = useMolcule(CounterMolecule, props);
+const counter = useMolecule(CounterMolecule, props);
 const value = useSignal(counter.count);
 </script>
 
@@ -169,10 +170,10 @@ function useMutableSignal<T>(signal: Signal<T>): WritableComputedRef<T>
 
 Wraps a Sigrea signal as a Vue `WritableComputedRef` for two-way bindings like `v-model`. Expects a writable signal created by `signal()`. Passing a readonly signal throws at runtime.
 
-### useMolcule
+### useMolecule
 
 ```ts
-function useMolcule<TReturn extends object, TProps = void>(
+function useMolecule<TReturn extends object, TProps = void>(
   molecule: MoleculeFactory<TReturn, TProps>,
   ...args: MoleculeArgs<TProps>
 ): MoleculeInstance<TReturn>
@@ -198,15 +199,54 @@ it("increments and displays the updated count", async () => {
 });
 ```
 
+## Handling Scope Cleanup Errors
+
+For global error handling configuration, see [@sigrea/core - Handling Scope Cleanup Errors](https://github.com/sigrea/core#handling-scope-cleanup-errors).
+
+In Vue apps, configure the handler in your application entry point before mounting:
+
+```ts
+// main.ts
+import { setScopeCleanupErrorHandler } from "@sigrea/core";
+import { createApp } from "vue";
+import App from "./App.vue";
+
+setScopeCleanupErrorHandler((error, context) => {
+  console.error(`Cleanup failed:`, error);
+
+  // Forward to monitoring service
+  if (typeof Sentry !== "undefined") {
+    Sentry.captureException(error, {
+      tags: { scopeId: context.scopeId, phase: context.phase },
+    });
+  }
+});
+
+createApp(App).mount("#app");
+```
+
 ## Development
 
-Development scripts prefer pnpm. npm or yarn work too, but pnpm keeps dependency resolution identical to CI.
+This repo targets Node.js 20 or later.
+
+If you use mise:
+
+- `mise trust -y` — trust `mise.toml` (first run only).
+- `mise run ci` — run CI-equivalent checks locally.
+- `mise run notes` — preview release notes (optional).
+
+You can also run pnpm scripts directly:
 
 - `pnpm install` — install dependencies.
 - `pnpm test` — run the Vitest suite once (no watch).
+- `pnpm typecheck` — run TypeScript type checking.
+- `pnpm test:coverage` — collect coverage.
 - `pnpm build` — compile via unbuild to produce dual CJS/ESM bundles.
+- `pnpm cicheck` — run CI checks locally.
 - `pnpm dev` — launch the playground counter demo.
 
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for workflow details.
+
 ## License
 
 MIT — see [LICENSE](./LICENSE).

package/dist/index.cjs

@@ -3,10 +3,10 @@
 const vue = require('vue');
 const core = require('@sigrea/core');
 
-function useMolcule(molecule, ...args) {
+function useMolecule(molecule, ...args) {
   if (vue.getCurrentInstance() === null) {
     throw new Error(
-      "useMolcule can only be used within a Vue component setup()."
+      "useMolecule can only be used within a Vue component setup()."
     );
   }
   const instance = molecule(...args);
@@ -85,7 +85,7 @@ function useMutableSignal(source) {
 
 exports.useComputed = useComputed;
 exports.useDeepSignal = useDeepSignal;
-exports.useMolcule = useMolcule;
+exports.useMolecule = useMolecule;
 exports.useMutableSignal = useMutableSignal;
 exports.useSignal = useSignal;
 exports.useSnapshot = useSnapshot;

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { MoleculeFactory, MoleculeArgs, MoleculeInstance, Signal, ReadonlySignal
 import * as vue from 'vue';
 import { DeepReadonly, ShallowRef } from 'vue';
 
-declare function useMolcule<TReturn extends object, TProps = void>(molecule: MoleculeFactory<TReturn, TProps>, ...args: MoleculeArgs<TProps>): MoleculeInstance<TReturn>;
+declare function useMolecule<TReturn extends object, TProps = void>(molecule: MoleculeFactory<TReturn, TProps>, ...args: MoleculeArgs<TProps>): MoleculeInstance<TReturn>;
 
 type ReadableSignal<T> = Signal<T> | ReadonlySignal<T>;
 declare function useSignal<T>(source: ReadableSignal<T>): Readonly<vue.Ref<vue.DeepReadonly<T>, vue.DeepReadonly<T>>>;
@@ -21,4 +21,4 @@ declare function useSnapshot<T>(handler: SnapshotHandler<T>, options: UseSnapsho
     mode: "mutable";
 }): ShallowRef<T>;
 
-export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolecule, useMutableSignal, useSignal, useSnapshot };

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { MoleculeFactory, MoleculeArgs, MoleculeInstance, Signal, ReadonlySignal
 import * as vue from 'vue';
 import { DeepReadonly, ShallowRef } from 'vue';
 
-declare function useMolcule<TReturn extends object, TProps = void>(molecule: MoleculeFactory<TReturn, TProps>, ...args: MoleculeArgs<TProps>): MoleculeInstance<TReturn>;
+declare function useMolecule<TReturn extends object, TProps = void>(molecule: MoleculeFactory<TReturn, TProps>, ...args: MoleculeArgs<TProps>): MoleculeInstance<TReturn>;
 
 type ReadableSignal<T> = Signal<T> | ReadonlySignal<T>;
 declare function useSignal<T>(source: ReadableSignal<T>): Readonly<vue.Ref<vue.DeepReadonly<T>, vue.DeepReadonly<T>>>;
@@ -21,4 +21,4 @@ declare function useSnapshot<T>(handler: SnapshotHandler<T>, options: UseSnapsho
     mode: "mutable";
 }): ShallowRef<T>;
 
-export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolecule, useMutableSignal, useSignal, useSnapshot };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { MoleculeFactory, MoleculeArgs, MoleculeInstance, Signal, ReadonlySignal
 import * as vue from 'vue';
 import { DeepReadonly, ShallowRef } from 'vue';
 
-declare function useMolcule<TReturn extends object, TProps = void>(molecule: MoleculeFactory<TReturn, TProps>, ...args: MoleculeArgs<TProps>): MoleculeInstance<TReturn>;
+declare function useMolecule<TReturn extends object, TProps = void>(molecule: MoleculeFactory<TReturn, TProps>, ...args: MoleculeArgs<TProps>): MoleculeInstance<TReturn>;
 
 type ReadableSignal<T> = Signal<T> | ReadonlySignal<T>;
 declare function useSignal<T>(source: ReadableSignal<T>): Readonly<vue.Ref<vue.DeepReadonly<T>, vue.DeepReadonly<T>>>;
@@ -21,4 +21,4 @@ declare function useSnapshot<T>(handler: SnapshotHandler<T>, options: UseSnapsho
     mode: "mutable";
 }): ShallowRef<T>;
 
-export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolecule, useMutableSignal, useSignal, useSnapshot };

package/dist/index.mjs

@@ -1,10 +1,10 @@
 import { getCurrentInstance, onScopeDispose, shallowRef, readonly, triggerRef, computed } from 'vue';
 import { disposeMolecule, createSignalHandler, createComputedHandler, createDeepSignalHandler } from '@sigrea/core';
 
-function useMolcule(molecule, ...args) {
+function useMolecule(molecule, ...args) {
   if (getCurrentInstance() === null) {
     throw new Error(
-      "useMolcule can only be used within a Vue component setup()."
+      "useMolecule can only be used within a Vue component setup()."
     );
   }
   const instance = molecule(...args);
@@ -81,4 +81,4 @@ function useMutableSignal(source) {
   });
 }
 
-export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolecule, useMutableSignal, useSignal, useSnapshot };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sigrea/vue",
-	"version": "0.3.0",
+	"version": "0.4.0",
 	"description": "Vue adapter bindings for Sigrea molecule modules.",
 	"license": "MIT",
 	"type": "module",
@@ -49,10 +49,11 @@
 		"test:coverage": "vitest --coverage",
 		"typecheck": "tsc -p tsconfig.json --noEmit",
 		"format": "biome check .",
-		"format:fix": "biome check --write ."
+		"format:fix": "biome check --write .",
+		"cicheck": "pnpm test && pnpm typecheck && pnpm format:fix"
 	},
 	"peerDependencies": {
-		"@sigrea/core": "^0.4.0",
+		"@sigrea/core": "^0.4.3",
 		"vue": "^3.4.0"
 	},
 	"devDependencies": {