@ecopages/signals 0.3.0-alpha.17 → 0.3.0-alpha.18

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ecopages/signals",
-	"version": "0.3.0-alpha.17",
+	"version": "0.3.0-alpha.18",
 	"description": "Renderer-agnostic signal primitives based on the TC39 Signals proposal",
 	"repository": {
 		"type": "git",
@@ -13,16 +13,16 @@
 	},
 	"author": "Andrea Zanenghi",
 	"license": "MIT",
-	"main": "dist/index.js",
-	"module": "dist/index.js",
-	"types": "dist/index.d.ts",
+	"main": "./index.js",
+	"module": "./index.js",
+	"types": "./index.d.ts",
 	"type": "module",
 	"publishConfig": {
 		"access": "public"
 	},
 	"sideEffects": false,
 	"files": [
-		"dist/**"
+		"**/*"
 	],
 	"keywords": [
 		"signals",
@@ -33,24 +33,11 @@
 	],
 	"exports": {
 		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
+			"types": "./index.d.ts",
+			"import": "./index.js"
 		},
 		"./package.json": "./package.json"
 	},
-	"scripts": {
-		"build:lib": "bun run clean && bun run build:files && bun run build:types",
-		"build:files": "bun run ./build.ts",
-		"build:types": "tsc -p tsconfig.build.json",
-		"clean": "rm -rf ./dist",
-		"size:check": "bun run ./check-size.ts",
-		"size:report": "bun run ./check-size.ts --report-only",
-		"test:lib": "vitest run"
-	},
-	"devDependencies": {
-		"@vitest/coverage-v8": "3.2.4",
-		"vitest": "^3.2.4"
-	},
 	"peerDependencies": {
 		"typescript": "^5"
 	}

package/README.md

@@ -1,109 +0,0 @@
-# Ecopages Signals
-
-`@ecopages/signals` is a renderer-agnostic signals package that can be used standalone or underneath Radiant.
-
-Its core model is based on the [TC39 Signals proposal](https://github.com/tc39/proposal-signals/tree/main), with a smaller surface area and a few convenience helpers for application code today.
-
-The public entrypoint remains `index.ts`, while the implementation now lives in focused modules under `src/` so the core runtime, effects, watcher support, and store logic can evolve independently.
-
-## Current Scope
-
-This package currently provides:
-
-- `State<T>` for writable values
-- `Computed<T>` for lazily derived values
-- `currentComputed()` for advanced derived helpers that need the active computed context
-- `effect(...)` for reactive side effects with scheduled re-execution
-- `watch(...)` for observing derived values with previous-value access
-- `untrack(...)` and `peek(...)` for non-tracking reads
-- `subtle.Watcher` plus `watched` and `unwatched` hooks for low-level invalidation workflows
-- `createStore(...)` for deep reactive object and array state
-- `isStore(...)` for detecting signal-backed store proxies
-- `snapshot(...)` for materializing plain nested data
-- automatic dependency discovery during `Computed` evaluation
-- subscription support for renderer or framework adapters
-
-## Source Layout
-
-The package is organized around a stable public barrel and smaller implementation files:
-
-- `index.ts` re-exports the public API and exposes `subtle`
-- `src/types.ts` defines the public contracts, options, and low-level symbols
-- `src/state.ts` implements writable `State` signals
-- `src/computed.ts` implements lazy derived `Computed` signals and active-computation helpers
-- `src/effect.ts` and `src/watch.ts` implement effect scheduling and derived-value observation
-- `src/watcher.ts` implements proposal-shaped low-level watchers
-- `src/tracking.ts` contains non-tracking read helpers
-- `src/store.ts` contains deep store proxying and snapshot materialization
-
-## Design Position
-
-This package is renderer-agnostic.
-
-- It does not know about JSX.
-- It does not know about Radiant components.
-- It is meant to work both as a standalone package and underneath adapters in those packages.
-
-## TC39 Relationship
-
-This package is based on the current TC39 Signals proposal and tracks the same broad model around:
-
-- `State` and `Computed` signal classes
-- lazy pull-based recomputation with cached values
-- automatic dependency discovery during computed evaluation
-- custom equality functions for writable and computed signals
-- untracked reads as an escape hatch
-
-It is not a drop-in implementation of the current proposal draft.
-
-It is best understood as proposal-aligned in its core semantics, but not yet fully API-compatible with the draft surface.
-
-- It exposes convenience helpers such as `effect(...)`, `watch(...)`, `createStore(...)`, and `snapshot(...)` directly.
-- It currently exposes manual `subscribe(...)` hooks for adapter and library integration.
-- It exposes a proposal-shaped `subtle.Watcher` API, while still keeping the existing convenience helpers.
-- Its `subtle.Watcher` follows the proposal-style re-arm behavior, where calling `watch(...)` resets the pending set and notification latch for the next invalidation cycle.
-- It does not yet expose the full TC39 subtle introspection surface.
-
-## API Notes
-
-- `subscribe(...)` is intended for adapter-style push integration. Application-level derived work is usually better expressed with `Computed`, `effect(...)`, or `watch(...)`.
-- `watch(...)` is built on top of a computed signal plus an effect, so it inherits computed equality behavior and effect scheduling.
-- `subtle.Watcher` reports staleness rather than recalculated values. Calling `watch(...)` is both registration and reset.
-- `createStore(...)` wraps nested plain objects and arrays, while `snapshot(...)` detaches the current plain value graph for logging, serialization, or comparison.
-
-## Example
-
-```ts
-import { Computed, State, createStore, effect, watch } from '@ecopages/signals';
-
-const count = new State(0);
-const parity = new Computed(() => ((count.get() & 1) === 0 ? 'even' : 'odd'));
-const store = createStore({ profile: { name: 'Ada' } });
-
-const dispose = effect(() => {
-	console.log(parity.get(), store.profile.name);
-});
-
-const stopWatching = watch(
-	() => store.profile.name,
-	(nextName, previousName) => {
-		console.log(previousName, '->', nextName);
-	},
-);
-
-count.set(1);
-store.profile.name = 'Grace';
-dispose();
-stopWatching();
-```
-
-## Limits
-
-This implementation is still smaller than the current TC39 proposal draft.
-
-- no full TC39 `Watcher` and subtle semantics surface yet
-- no full proposal-style subtle introspection helpers yet
-- no batching or transaction model
-- no framework-owned disposal tree or component ownership integration yet
-
-Those omissions are deliberate. The goal is to keep a small, useful standalone package while leaving room to align further as the proposal evolves.

package/dist/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026-present Andrea Zanenghi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/package.json

@@ -1,44 +0,0 @@
-{
-	"name": "@ecopages/signals",
-	"version": "0.3.0-alpha.17",
-	"description": "Renderer-agnostic signal primitives based on the TC39 Signals proposal",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/ecopages/radiant.git",
-		"directory": "packages/signals"
-	},
-	"homepage": "https://github.com/ecopages/radiant/tree/main/packages/signals#readme",
-	"bugs": {
-		"url": "https://github.com/ecopages/radiant/issues"
-	},
-	"author": "Andrea Zanenghi",
-	"license": "MIT",
-	"main": "./index.js",
-	"module": "./index.js",
-	"types": "./index.d.ts",
-	"type": "module",
-	"publishConfig": {
-		"access": "public"
-	},
-	"sideEffects": false,
-	"files": [
-		"**/*"
-	],
-	"keywords": [
-		"signals",
-		"reactivity",
-		"tc39",
-		"state-management",
-		"radiant"
-	],
-	"exports": {
-		".": {
-			"types": "./index.d.ts",
-			"import": "./index.js"
-		},
-		"./package.json": "./package.json"
-	},
-	"peerDependencies": {
-		"typescript": "^5"
-	}
-}