xote 1.0.1

package/.gitattributes

@@ -0,0 +1,2 @@
+*.mjs linguist-generated
+dist/* linguist-generated

package/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch: {}
+
+permissions:
+  contents: write          # create releases, push changelog commits
+  issues: write            # (optional) if plugins comment on issues
+  pull-requests: write     # (optional) if plugins post to PRs
+  id-token: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # semantic-release needs full history & tags
+
+      - name: Use Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24.10.0
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bernardo Gurgel
+
+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/README.md

@@ -0,0 +1,317 @@
+# xote (pronounced [ˈʃɔtʃi])
+
+A lightweight, zero-dependency UI library for ReScript with fine-grained reactivity powered by signals. Build reactive web applications with automatic dependency tracking and efficient updates.
+
+## Features
+
+- **Zero dependencies** - No runtime dependencies, pure ReScript implementation
+- **Reactive primitives** - Signals, computed values, and effects
+- **Component system** - Declarative UI components with automatic reactive updates
+- **Automatic dependency tracking** - No manual subscription management
+- **Batching and control** - Support for untracked reads and batched updates
+- **Lightweight** - Small bundle size, minimal overhead
+
+## Getting Started
+
+Comming soon.
+
+### Installation
+
+Comming soon.
+
+### Quick Example
+
+```rescript
+open Xote
+
+// Create reactive state
+let count = Signal.make(0)
+
+// Create computed values
+let doubled = Computed.make(() => Signal.get(count) * 2)
+
+// Define event handlers
+let increment = (_evt: Dom.event) => Signal.update(count, n => n + 1)
+
+// Build your UI
+let app = Component.div(
+  ~children=[
+    Component.h1(~children=[Component.text("Counter")], ()),
+    Component.p(~children=[
+      Component.textSignal(
+        Computed.make(() => "Count: " ++ Int.toString(Signal.get(count)))
+      )
+    ], ()),
+    Component.button(
+      ~events=[("click", increment)],
+      ~children=[Component.text("Increment")],
+      ()
+    )
+  ],
+  ()
+)
+
+// Mount to DOM
+Component.mountById(app, "app")
+```
+
+## API Reference
+
+### Signals - Reactive State
+
+Signals are the foundation of reactive state management in Xote.
+
+```rescript
+// Create a signal with initial value
+let count = Signal.make(0)
+
+// Read signal value (tracks dependencies)
+let value = Signal.get(count) // => 0
+
+// Read without tracking
+let value = Signal.peek(count) // => 0
+
+// Update signal value
+Signal.set(count, 1)
+
+// Update with a function
+Signal.update(count, n => n + 1)
+```
+
+### Computed - Derived State
+
+Computed values automatically update when their dependencies change.
+
+```rescript
+let count = Signal.make(5)
+
+// Computed values are signals that derive from other signals
+let doubled = Computed.make(() => Signal.get(count) * 2)
+
+Signal.get(doubled) // => 10
+
+Signal.set(count, 10)
+Signal.get(doubled) // => 20
+```
+
+### Effects - Side Effects
+
+Effects run automatically when their dependencies change.
+
+```rescript
+let count = Signal.make(0)
+
+// Effect runs immediately and re-runs when count changes
+let disposer = Effect.run(() => {
+  Console.log("Count is now: " ++ Int.toString(Signal.get(count)))
+})
+
+Signal.set(count, 1) // Logs: "Count is now: 1"
+
+// Clean up effect
+disposer.dispose()
+```
+
+### Components - Building UI
+
+#### Basic Elements
+
+```rescript
+// Text nodes
+Component.text("Hello, world!")
+
+// Reactive text from signals
+let name = Signal.make("Alice")
+Component.textSignal(
+  Computed.make(() => "Hello, " ++ Signal.get(name))
+)
+
+// HTML elements
+Component.div(
+  ~attrs=[("class", "container"), ("id", "main")],
+  ~events=[("click", handleClick)],
+  ~children=[
+    Component.h1(~children=[Component.text("Title")], ()),
+    Component.p(~children=[Component.text("Content")], ())
+  ],
+  ()
+)
+```
+
+#### Reactive Lists
+
+Render lists that automatically update when data changes:
+
+```rescript
+let todos = Signal.make([
+  {id: 1, text: "Learn Xote"},
+  {id: 2, text: "Build an app"}
+])
+
+let todoItem = (todo) => {
+  Component.li(~children=[Component.text(todo.text)], ())
+}
+
+Component.ul(
+  ~children=[Component.list(todos, todoItem)],
+  ()
+)
+// List updates automatically when todos signal changes!
+```
+
+#### Event Handling
+
+```rescript
+let handleClick = (evt: Dom.event) => {
+  Console.log("Clicked!")
+}
+
+Component.button(
+  ~events=[("click", handleClick), ("mouseenter", handleHover)],
+  ~children=[Component.text("Click me")],
+  ()
+)
+```
+
+### Utilities
+
+#### Untracked Reads
+
+Read signals without creating dependencies.
+
+```rescript
+Core.untrack(() => {
+  let value = Signal.get(count) // Won't track this read
+  Console.log(value)
+})
+```
+
+#### Batching Updates
+
+Group multiple updates to run effects only once.
+
+```rescript
+Core.batch(() => {
+  Signal.set(count1, 10)
+  Signal.set(count2, 20)
+  Signal.set(count3, 30)
+})
+// Effects run once after all updates
+```
+
+## Complete Example
+
+### Counter Application
+
+```rescript
+open Xote
+
+// State management
+let counterValue = Signal.make(0)
+
+// Derived state
+let counterDisplay = Computed.make(() =>
+  "Count: " ++ Int.toString(Signal.get(counterValue))
+)
+
+let isEven = Computed.make(() =>
+  mod(Signal.get(counterValue), 2) == 0
+)
+
+// Event handlers
+let increment = (_evt: Dom.event) => {
+  Signal.update(counterValue, n => n + 1)
+}
+
+let decrement = (_evt: Dom.event) => {
+  Signal.update(counterValue, n => n - 1)
+}
+
+let reset = (_evt: Dom.event) => {
+  Signal.set(counterValue, 0)
+}
+
+// Side effects
+let _ = Effect.run(() => {
+  Console.log("Counter changed: " ++ Int.toString(Signal.get(counterValue)))
+})
+
+// UI Component
+let app = Component.div(
+  ~attrs=[("class", "app")],
+  ~children=[
+    Component.h1(~children=[Component.text("Xote Counter")], ()),
+
+    Component.div(
+      ~attrs=[("class", "counter-display")],
+      ~children=[
+        Component.h2(~children=[Component.textSignal(counterDisplay)], ()),
+        Component.p(~children=[
+          Component.textSignal(
+            Computed.make(() =>
+              Signal.get(isEven) ? "Even" : "Odd"
+            )
+          )
+        ], ())
+      ],
+      ()
+    ),
+
+    Component.div(
+      ~attrs=[("class", "controls")],
+      ~children=[
+        Component.button(
+          ~events=[("click", decrement)],
+          ~children=[Component.text("-")],
+          ()
+        ),
+        Component.button(
+          ~events=[("click", reset)],
+          ~children=[Component.text("Reset")],
+          ()
+        ),
+        Component.button(
+          ~events=[("click", increment)],
+          ~children=[Component.text("+")],
+          ()
+        )
+      ],
+      ()
+    )
+  ],
+  ()
+)
+
+// Mount to DOM
+Component.mountById(app, "app")
+```
+
+## How It Works
+
+### Reactive System
+
+- **Automatic dependency tracking** - When you read a signal with `Signal.get()` inside a computed or effect, it automatically tracks that dependency
+- **Fine-grained updates** - Only the specific computeds and effects that depend on changed signals are re-executed
+- **Synchronous by default** - Updates happen immediately and synchronously for predictable behavior
+- **Batching support** - Group multiple updates to minimize re-computation
+
+### Component Rendering
+
+- **Initial render** - Components are rendered to real DOM elements on mount
+- **Reactive text** - `textSignal()` creates text nodes that automatically update when their signal changes
+- **Reactive lists** - `Component.list()` creates lists that automatically update when data changes
+- **Direct DOM manipulation** - No virtual DOM diffing, updates are precise and efficient
+- **Effect-based** - Signal changes trigger effects that update specific DOM nodes automatically
+
+## Best Practices
+
+1. **Keep signals at the top level** - Define signals outside component definitions for proper reactivity
+2. **Use computed for derived state** - Don't repeat calculations, use `Computed.make()`
+3. **Use `Component.list()` for reactive arrays** - Let the framework handle list updates automatically
+4. **Batch related updates** - Use `Core.batch()` when updating multiple signals together
+5. **Dispose effects when done** - Call `disposer.dispose()` for effects you no longer need
+6. **Use `peek()` when you don't want tracking** - Read signal values without creating dependencies
+
+## License
+
+MIT © 2025

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e,o,t,r,a;exports.Component=e;exports.Computed=o;exports.Core=t;exports.Effect=r;exports.Signal=a;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/Xote.res.mjs"],"sourcesContent":["// Generated by ReScript, PLEASE EDIT WITH CARE\n\n\nvar Component;\n\nvar Computed;\n\nvar Core;\n\nvar Effect;\n\nvar Signal;\n\nexport {\n  Component ,\n  Computed ,\n  Core ,\n  Effect ,\n  Signal ,\n}\n/* No side effect */\n"],"names":["Component","Computed","Core","Effect","Signal"],"mappings":"gFAGG,IAACA,EAEAC,EAEAC,EAEAC,EAEAC"}

package/dist/index.mjs

@@ -0,0 +1,9 @@
+var r, a, e, o, v;
+export {
+  r as Component,
+  a as Computed,
+  e as Core,
+  o as Effect,
+  v as Signal
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/Xote.res.mjs"],"sourcesContent":["// Generated by ReScript, PLEASE EDIT WITH CARE\n\n\nvar Component;\n\nvar Computed;\n\nvar Core;\n\nvar Effect;\n\nvar Signal;\n\nexport {\n  Component ,\n  Computed ,\n  Core ,\n  Effect ,\n  Signal ,\n}\n/* No side effect */\n"],"names":["Component","Computed","Core","Effect","Signal"],"mappings":"AAGG,IAACA,GAEAC,GAEAC,GAEAC,GAEAC;"}

package/dist/index.umd.js

@@ -0,0 +1,2 @@
+(function(e,n){typeof exports=="object"&&typeof module!="undefined"?n(exports):typeof define=="function"&&define.amd?define(["exports"],n):(e=typeof globalThis!="undefined"?globalThis:e||self,n(e.xote={}))})(this,(function(e){"use strict";var n,o,t,f,i;e.Component=n,e.Computed=o,e.Core=t,e.Effect=f,e.Signal=i,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})}));
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/Xote.res.mjs"],"sourcesContent":["// Generated by ReScript, PLEASE EDIT WITH CARE\n\n\nvar Component;\n\nvar Computed;\n\nvar Core;\n\nvar Effect;\n\nvar Signal;\n\nexport {\n  Component ,\n  Computed ,\n  Core ,\n  Effect ,\n  Signal ,\n}\n/* No side effect */\n"],"names":["Component","Computed","Core","Effect","Signal"],"mappings":"+OAGG,IAACA,EAEAC,EAEAC,EAEAC,EAEAC"}

package/docs/CHANGELOG.md

@@ -0,0 +1,20 @@
+## [1.0.1](https://github.com/brnrdog/xote/compare/v1.0.0...v1.0.1) (2025-10-30)
+
+
+### Bug Fixes
+
+* version bump for release ([72fb74f](https://github.com/brnrdog/xote/commit/72fb74f2cf3d4a2389daf5363457d5d7ad4eaed1))
+
+# 1.0.0 (2025-10-30)
+
+
+### Bug Fixes
+
+* improve signal reactivity and add todo styling ([495f0bb](https://github.com/brnrdog/xote/commit/495f0bb52eaa8de89214f957f30b078f07029569))
+
+
+### Features
+
+* add Component system with automatic reactivity ([38815ed](https://github.com/brnrdog/xote/commit/38815ed3d1400c5511b790011d60081b317a69ac))
+* add demo ([cf3faf3](https://github.com/brnrdog/xote/commit/cf3faf34c07d85a60d78d5f9539d2e2132f3b85a))
+* minimal signal implementation based on the TC39 proposal ([9b78d0b](https://github.com/brnrdog/xote/commit/9b78d0b62ba21c953d909459036246f334b6613e))

package/index.html

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Xote Demo</title>
+	<script src="https://cdn.tailwindcss.com"></script>
+	<script>
+		tailwind.config = {
+			darkMode: 'class',
+			theme: {
+				extend: {}
+			}
+		}
+	</script>
+	<style>
+		.todo-list li.completed span {
+			text-decoration: line-through;
+			@apply text-gray-500 dark:text-gray-400;
+		}
+	</style>
+</head>
+<body class="bg-gray-50 dark:bg-gray-900 min-h-screen">
+	<div id="app"></div>
+	<script type="module" src="./src/demo/TodoApp.res.mjs">
+	</script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "xote",
+  "version": "1.0.1",
+  "repository": {
+    "url": "https://github.com/brnrdog/xote"
+  },
+  "scripts": {
+    "res:build": "rescript",
+    "res:clean": "rescript clean",
+    "res:dev": "rescript -w",
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "keywords": [
+    "rescript",
+    "signals"
+  ],
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      [
+        "@semantic-release/changelog",
+        {
+          "changelogFile": "docs/CHANGELOG.md"
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "docs/CHANGELOG.md"
+          ]
+        }
+      ],
+      "@semantic-release/npm"
+    ]
+  },
+  "author": "Bernardo Gurgel <brnrdog@hey.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@rescript/core": "^1.6.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.0",
+    "@semantic-release/npm": "^13.1.1",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "rescript": "^11.1.4",
+    "semantic-release": "^25.0.1",
+    "vite": "^7.1.12"
+  }
+}

package/rescript.json

@@ -0,0 +1,18 @@
+{
+  "name": "xote",
+  "sources": {
+    "dir": "src",
+    "subdirs": true
+  },
+  "package-specs": {
+    "module": "esmodule",
+    "in-source": true
+  },
+  "suffix": ".res.mjs",
+  "bs-dependencies": [
+    "@rescript/core"
+  ],
+  "bsc-flags": [
+    "-open RescriptCore"
+  ]
+}

package/src/Xote.res

@@ -0,0 +1,5 @@
+module Component = Xote__Component
+module Computed = Xote__Computed
+module Core = Xote__Core
+module Effect = Xote__Effect
+module Signal = Xote__Signal

package/src/Xote.res.mjs

@@ -0,0 +1,21 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+
+var Component;
+
+var Computed;
+
+var Core;
+
+var Effect;
+
+var Signal;
+
+export {
+  Component ,
+  Computed ,
+  Core ,
+  Effect ,
+  Signal ,
+}
+/* No side effect */