@uistate/core 4.0.1 → 4.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Imsirovic Ajdin
+
+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

@@ -1,37 +1,11 @@
-# @uistate/core v3.1.2
+# UIstate
 
-**author**: Ajdin Imsirovic <ajdika@live.com> (GitHub)  
-**maintainer**: uistate <ajdika.i@gmail.com> (npm)
+A revolutionary approach to UI state management using CSS custom properties and DOM attributes, featuring Attribute-Driven State Inheritance (ADSI).
 
-High-performance UI state management using CSS custom properties and ADSI (Attribute-Driven State Inheritance). Focused heavily on DX and performance with a fully declarative approach.
+**Current Version**: 4.1.1
 
-## What's New in v3.1.1
-
-- 🛠️ Added `setStates()` method for batch state updates
-- 🧩 Added `registerSpecialHandler()` and `registerEventBinding()` for extensibility
-- 🏷️ New `setupObservers()` for automatic state-to-DOM binding
-- ⚡ Improved `setupStateActions()` with customizable event handling
-- 💾 Default event handlers for clicks and inputs with declarative binding
-- 🗡️ Enhanced attribute serialization with specialized handlers
-
-## What's New in v3.0.0
-
-- 🔄 Fully declarative state management approach
-- 🧩 Enhanced template system with CSS-based templates
-- 🚀 Improved performance through optimized state propagation
-- 📦 New state serialization and inspection capabilities
-- 🔍 Telemetry plugin for better debugging
-
-## Features
-
-- 🚀 O(1) state updates using CSS custom properties
-- 📉 Significant memory savings compared to virtual DOM approaches
-- 🎯 Zero configuration
-- 🔄 Automatic reactivity through CSS cascade
-- 🎨 Framework agnostic
-- 📦 Tiny bundle size (~2KB)
-- 🧩 Modular architecture with dedicated modules for CSS state and templates
-- 📝 Declarative HTML-in-CSS templates
+**Author**: Ajdin Imsirovic <ajdika@live.com> (GitHub)  
+**Maintainer**: uistate <ajdika.i@gmail.com> (npm)
 
 ## Installation
 
@@ -39,85 +13,73 @@ High-performance UI state management using CSS custom properties and ADSI (Attri
 npm install @uistate/core
 ```
 
-## Why @uistate/core?
-
-### Performance
+## Quick Start
 
-- **CSS-Driven Updates**: Leverages browser's CSS engine for optimal performance with O(1) complexity
-- **DOM as Source of Truth**: Efficient state storage using CSS custom properties and data attributes
-- **Minimal Overhead**: No virtual DOM diffing or shadow DOM needed
+UIstate v4.1.1 provides four core modules that can be imported individually:
 
-### Developer Experience
+```javascript
+import { createCssState, createEventState, stateSerializer, createTemplateManager } from '@uistate/core';
 
-- **Declarative API**: Define UI structure in CSS templates
-- **Framework Agnostic**: Works with any framework or vanilla JavaScript
-- **Zero Config**: No store setup, no reducers, no actions
-- **CSS-Native**: Leverages the power of CSS selectors and the cascade
+// Create CSS-based state management
+const cssState = createCssState();
 
-### Core Concepts
+// Create event-based state management  
+const eventState = createEventState();
 
-- **Attribute-Driven State Inheritance (ADSI)**: State represented both as CSS variables and data attributes
-- **Declarative Templates**: Define UI components directly in CSS
-- **Automatic State Propagation**: State changes automatically update the UI
+// Use state serialization utilities
+const serialized = stateSerializer.serialize(myState);
 
-## Project Structure
-
-```
-@uistate/core/
-├── src/                    # Core library
-│   ├── index.js           # Main entry 
-│   ├── cssState.js        # CSS variables management
-│   ├── templateManager.js # Declarative template management
-│   ├── stateInspector.js  # State inspection tools
-│   └── stateSerializer.js # State serialization
-└── examples/              # Example applications
-    └── 001-.../ # Progressive examples from simpler to more complex
+// Create template manager for declarative UI
+const templateManager = createTemplateManager();
 ```
 
-## Browser Support
+## Core Modules
 
-- Chrome 60+
-- Firefox 54+
-- Safari 10.1+
-- Edge 79+
-
-# Core Ideas Behind UIstate
+### `createCssState`
+Manages state using CSS custom properties for optimal performance and automatic reactivity.
 
-UIstate is a JavaScript-based UI state management system that leverages CSS custom properties and HTML-in-CSS templates for a fully declarative approach to building UIs.
+### `createEventState` 
+Provides event-driven state management with pub/sub patterns.
 
-## Key Components
+### `stateSerializer`
+Utilities for serializing and deserializing state data.
 
-### UIstate Core
+### `createTemplateManager`
+Declarative template management system for building UIs with CSS-based templates.
 
-The main UIstate object provides methods to manage state and templates:
+## Key Features
 
-- **init()**: Initialize the UIstate system
-- **setState()**: Set state values
-- **getState()**: Get state values
-- **subscribe()**: Subscribe to state changes
-- **observe()**: Observe state paths for changes
+- Potentially O(1) state updates
+- Significant memory savings compared to virtual DOM approaches
+- DOM as the single source of truth
+- CSS-driven state derivation
+- Framework agnostic
+- Tiny bundle size (~30KB uncompressed, ~8-10KB gzipped)
+- Zero dependencies
+- Modular architecture - import only what you need
 
-### Template Manager
+## Browser Support
 
-The template manager provides tools for declarative UI rendering:
+- Chrome 60+
+- Firefox 54+
+- Safari 10.1+
+- Edge 79+
 
-- **renderTemplateFromCss()**: Render UI components from CSS-defined templates
-- **registerActions()**: Register event handlers for UI components
-- **attachDelegation()**: Set up event delegation for efficient event handling
+## Philosophy
 
-## Key Features
+UIstate challenges traditional assumptions in web development by using the DOM as the source of truth for state, leveraging CSS variables and data attributes for state storage, and using the CSS cascade for state inheritance and derivation.
 
-1. Uses CSS custom properties as a storage mechanism, making state changes automatically trigger UI updates
-2. Provides a clear separation between state storage (CSS) and behavior (JavaScript)
-3. Implements a pub/sub pattern for reactive updates
-4. Leverages CSS templates for declarative UI definition
+The v4.1.0 release focuses on simplicity and modularity - providing clean, individual modules that can be composed together as needed, without the complexity of a unified framework.
 
-This implementation is particularly useful for building UI components with clean separation of concerns, optimal performance, and a fully declarative approach.
+## Examples
 
-## Contributing
+Explore our documentation and examples to see UIstate in action:
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+- Range sliders with different state derivation approaches
+- Button toggles with CSS state projection
+- Font adjusters with domain-based state management
+- And more!
 
 ## License
 
-MIT © Ajdin Imsirovic
+MIT  Ajdin Imsirovic

package/package.json

@@ -1,34 +1,34 @@
 {
   "name": "@uistate/core",
-  "version": "4.0.1",
+  "version": "4.1.1",
+  "description": "Revolutionary DOM-based state management using CSS custom properties - zero dependencies, potential O(1) updates",
   "type": "module",
-  "description": "High-performance UI state management using CSS custom properties and ADSI (Attribute-Driven State Inheritance)",
-  "main": "src/index.js",
-  "module": "src/index.js",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./cssState": "./cssState.js",
+    "./eventState": "./eventState.js",
+    "./stateSerializer": "./stateSerializer.js",
+    "./templateManager": "./templateManager.js"
+  },
   "files": [
-    "src"
+    "index.js",
+    "cssState.js",
+    "eventState.js", 
+    "stateSerializer.js",
+    "templateManager.js"
   ],
-  "scripts": {},
   "keywords": [
     "state-management",
-    "ui",
-    "css",
-    "performance",
-    "framework-agnostic",
-    "vanilla-js"
-  ],
-  "author": "Ajdin Imsirovic <ajdika@live.com> (GitHub)",
-  "contributors": [
-    "uistate <ajdika.i@gmail.com> (npm)"
+    "css-variables",
+    "dom-events",
+    "zero-dependency",
+    "modular"
   ],
+  "author": "Ajdin Imsirovic",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ImsirovicAjdin/uistate.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ImsirovicAjdin/uistate/issues"
-  },
-  "homepage": "https://github.com/ImsirovicAjdin/uistate#readme",
-  "sideEffects": false
+    "url": "https://github.com/ImsirovicAjdin/uistate"
+  }
 }