@sigrea/vue 0.2.1 → 0.3.0

package/README.md

@@ -1,19 +1,19 @@
 # @sigrea/vue
 
-`@sigrea/vue` adapts [@sigrea/core](https://www.npmjs.com/package/@sigrea/core) logic modules and signals for Vue 3's Composition API. It aligns lifecycle scopes with component lifecycles, preserves deep reactivity, and provides composables for `<script setup>` and traditional setup functions.
+`@sigrea/vue` adapts [@sigrea/core](https://www.npmjs.com/package/@sigrea/core) molecule modules and signals for Vue 3's Composition API. It aligns lifecycle scopes with component lifecycles, preserves deep reactivity, and provides composables for `<script setup>` and traditional setup functions.
 
 - **Signal subscriptions.** `useSignal` subscribes to signals and computed values, returning a readonly ref that updates when they change.
 - **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`.
-- **Logic lifecycles.** `useLogic` mounts logic factories and binds their lifecycles to Vue components.
+- **Molecule lifecycles.** `useMolcule` mounts molecule factories and binds their lifecycles to Vue components.
 
 ## Table of Contents
 
 - [Install](#install)
 - [Quick Start](#quick-start)
   - [Consume a Signal](#consume-a-signal)
-  - [Bridge Framework-Agnostic Logic](#bridge-framework-agnostic-logic)
+  - [Bridge Framework-Agnostic Molecules](#bridge-framework-agnostic-molecules)
   - [Bind Writable Primitive Signals](#bind-writable-primitive-signals)
   - [Bind Deep Reactive Objects](#bind-deep-reactive-objects)
 - [API Reference](#api-reference)
@@ -21,7 +21,7 @@
   - [useComputed](#usecomputed)
   - [useDeepSignal](#usedeepsignal)
   - [useMutableSignal](#usemutablesignal)
-  - [useLogic](#uselogic)
+  - [useMolcule](#usemolcule)
 - [Testing](#testing)
 - [Development](#development)
 - [License](#license)
@@ -52,13 +52,13 @@ const value = useSignal(count);
 </template>
 ```
 
-### Bridge Framework-Agnostic Logic
+### Bridge Framework-Agnostic Molecules
 
 ```ts
-// CounterLogic.ts
-import { defineLogic, signal } from "@sigrea/core";
+// CounterMolecule.ts
+import { molecule, signal } from "@sigrea/core";
 
-export const CounterLogic = defineLogic<{ initialCount: number }>()((props) => {
+export const CounterMolecule = molecule((props: { initialCount: number }) => {
   const count = signal(props.initialCount);
 
   const increment = () => {
@@ -76,11 +76,11 @@ export const CounterLogic = defineLogic<{ initialCount: number }>()((props) => {
 ```vue
 <!-- Counter.vue -->
 <script setup lang="ts">
-import { useLogic, useSignal } from "@sigrea/vue";
-import { CounterLogic } from "./CounterLogic";
+import { useMolcule, useSignal } from "@sigrea/vue";
+import { CounterMolecule } from "./CounterMolecule";
 
 const props = defineProps<{ initialCount: number }>();
-const counter = useLogic(CounterLogic, props);
+const counter = useMolcule(CounterMolecule, props);
 const value = useSignal(counter.count);
 </script>
 
@@ -169,27 +169,24 @@ 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.
 
-### useLogic
+### useMolcule
 
 ```ts
-function useLogic<TReturn extends object, TProps = void>(
-  logic: LogicFunction<TReturn, TProps>,
-  ...args: LogicArgs<TProps>
-): LogicInstance<TReturn>
+function useMolcule<TReturn extends object, TProps = void>(
+  molecule: MoleculeFactory<TReturn, TProps>,
+  ...args: MoleculeArgs<TProps>
+): MoleculeInstance<TReturn>
 ```
 
-Mounts a logic factory and returns its LogicInstance. Sigrea augments the logic with lifecycle metadata: `onMount` callbacks run after the component mounts, and `onUnmount` callbacks run before it unmounts.
+Mounts a molecule factory and returns its MoleculeInstance. Sigrea augments the molecule with lifecycle metadata: `onMount` callbacks run after the component mounts, and `onUnmount` callbacks run before it unmounts.
 
 ## Testing
 
 ```ts
 // tests/Counter.test.ts
 import { mount } from "@vue/test-utils";
-import { cleanupLogics } from "@sigrea/core";
 import Counter from "../components/Counter.vue";
 
-afterEach(() => cleanupLogics());
-
 it("increments and displays the updated count", async () => {
   const wrapper = mount(Counter, {
     props: { initialCount: 10 },

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { LogicFunction, LogicArgs, LogicInstance, Signal, ReadonlySignal, Computed, DeepSignal, SnapshotHandler } from '@sigrea/core';
+import { MoleculeFactory, MoleculeArgs, MoleculeInstance, Signal, ReadonlySignal, Computed, DeepSignal, SnapshotHandler } from '@sigrea/core';
 import * as vue from 'vue';
 import { DeepReadonly, ShallowRef } from 'vue';
 
-declare function useLogic<TReturn extends object, TProps = void>(logic: LogicFunction<TReturn, TProps>, ...args: LogicArgs<TProps>): LogicInstance<TReturn>;
+declare function useMolcule<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, useLogic, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { LogicFunction, LogicArgs, LogicInstance, Signal, ReadonlySignal, Computed, DeepSignal, SnapshotHandler } from '@sigrea/core';
+import { MoleculeFactory, MoleculeArgs, MoleculeInstance, Signal, ReadonlySignal, Computed, DeepSignal, SnapshotHandler } from '@sigrea/core';
 import * as vue from 'vue';
 import { DeepReadonly, ShallowRef } from 'vue';
 
-declare function useLogic<TReturn extends object, TProps = void>(logic: LogicFunction<TReturn, TProps>, ...args: LogicArgs<TProps>): LogicInstance<TReturn>;
+declare function useMolcule<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, useLogic, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { LogicFunction, LogicArgs, LogicInstance, Signal, ReadonlySignal, Computed, DeepSignal, SnapshotHandler } from '@sigrea/core';
+import { MoleculeFactory, MoleculeArgs, MoleculeInstance, Signal, ReadonlySignal, Computed, DeepSignal, SnapshotHandler } from '@sigrea/core';
 import * as vue from 'vue';
 import { DeepReadonly, ShallowRef } from 'vue';
 
-declare function useLogic<TReturn extends object, TProps = void>(logic: LogicFunction<TReturn, TProps>, ...args: LogicArgs<TProps>): LogicInstance<TReturn>;
+declare function useMolcule<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, useLogic, useMutableSignal, useSignal, useSnapshot };
+export { useComputed, useDeepSignal, useMolcule, useMutableSignal, useSignal, useSnapshot };

package/dist/index.mjs

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

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@sigrea/vue",
-	"version": "0.2.1",
-	"description": "Vue adapter bindings for Sigrea logic modules.",
+	"version": "0.3.0",
+	"description": "Vue adapter bindings for Sigrea molecule modules.",
 	"license": "MIT",
 	"type": "module",
 	"packageManager": "pnpm@10.0.0",
@@ -36,7 +36,7 @@
 		"signals",
 		"reactivity",
 		"vue",
-		"logic",
+		"molecule",
 		"typescript"
 	],
 	"scripts": {
@@ -52,7 +52,7 @@
 		"format:fix": "biome check --write ."
 	},
 	"peerDependencies": {
-		"@sigrea/core": "^0.3.1",
+		"@sigrea/core": "^0.4.0",
 		"vue": "^3.4.0"
 	},
 	"devDependencies": {