@biglogic/rgs 2.7.0 → 2.9.0

package/{dist/README.md → README.md}

@@ -24,25 +24,25 @@ We took the simplicity of **React Globo State (RGS)** and fused it with the arch
 
 | Feature | useState | gState |
 |---------|----------|--------|
-| **State globale tra componenti** | ❌ Servono Context/props | ✅ Condivisione automatica |
-| **Provider wrapper** | ❌ Necessario | ✅ Non serve |
-| **Persistenza (localStorage)** | ❌ Manuale | ✅ Built-in |
-| **Crittografia dati** | ❌ | ✅ AES-256-GCM |
-| **Namespace/stores multipli** | ❌ | ✅ |
-| **Plugin (Immer, Undo/Redo)** | ❌ | ✅ |
+| **Global state across components** | ❌ Need Context/props | ✅ Automatic sharing |
+| **Provider wrapper** | ❌ Required | ✅ Not needed |
+| **Persistence (localStorage)** | ❌ Manual | ✅ Built-in |
+| **Data encryption** | ❌ | ✅ AES-256-GCM |
+| **Multiple namespaces/stores** | ❌ | ✅ |
+| **Plugins (Immer, Undo/Redo)** | ❌ | ✅ |
 | **Audit logging** | ❌ | ✅ |
 | **RBAC/GDPR consent** | ❌ | ✅ |
-| **SSR/Hydration** | ❌ Manuale | ✅ Automatico |
+| **SSR/Hydration** | ❌ Manual | ✅ Automatic |
 | **Computed values** | ❌ | ✅ |
 
-### Quando usare cosa?
+### When to use what?
 
-- **useState**: UI locale, un componente, state temporaneo
+- **useState**: Local UI, single component, temporary state
 - **gState**:
-  - State condiviso tra più componenti
-  - Dati persistenti (preferenze, carrello, autenticazione)
-  - Dati sensibili (crittografia)
-  - Feature advanced (undo/redo, snapshots)
+  - Shared state across multiple components
+  - Persistent data (preferences, cart, authentication)
+  - Sensitive data (encryption)
+  - Advanced features (undo/redo, snapshots)
   - Enterprise (audit, RBAC, GDPR)
 
 ---
@@ -72,39 +72,6 @@ graph TB
     G --> O[Schema]
     G --> P[Analytics]
 ```
-┌─────────────────────────────────────────────────────────────────┐
-│                        React Globo State                        │
-│                         "The Magnetar"                          │
-└─────────────────────────────────────────────────────────────────┘
-                              │
-        ┌─────────────────────┼─────────────────────┐
-        ▼                     ▼                     ▼
-┌───────────────┐    ┌───────────────┐    ┌───────────────┐
-│   gstate()    │    │  useStore()   │    │ createStore() │
-│  (One-liner)  │    │   (Hook)      │    │   (Classic)   │
-└───────┬───────┘    └───────┬───────┘    └───────┬───────┘
-        │                    │                    │
-        └────────────────────┼────────────────────┘
-                             ▼
-                    ┌────────────────┐
-                    │   IStore       │
-                    │  (Core API)    │
-                    └────────┬───────┘
-                             │
-     ┌──────────┬───────────┼───────────┬──────────┐
-     ▼          ▼           ▼           ▼          ▼
-┌─────────┐ ┌─────────┐ ┌──────────┐ ┌────────┐ ┌─────────┐
-│ Storage │ │Immer    │ │ Plugins  │ │Security│ │ Async  │
-│Adapter  │ │Proxy    │ │ System   │ │ Layer  │ │ Store  │
-└────┬────┘ └────┬────┘ └────┬─────┘ └───┬────┘ └───┬────┘
-     │           │           │            │          │
-     ▼           ▼           ▼            ▼          ▼
-  local    ┌─────────┐   ┌──────┐   ┌─────────┐  ┌──────┐
-  session  │Frozen   │   │Add   │   │AES-256  │  │Fetch │
-  memory   │State    │   │Hooks │   │Encryption│  │+Loading│
-           └─────────┘   └──────┘   └─────────┘  │Error  │
-                                                  └──────┘
-```
 
 ### Core Components
 
@@ -132,7 +99,7 @@ graph TB
 Best for modern applications. Clean imports, zero global pollution.
 
 ```tsx
-import { gstate } from 'argis'
+import { gstate } from '@biglogic/rgs'
 
 // Create store and hook in one line
 const useCounter = gstate({ count: 0 })
@@ -147,7 +114,7 @@ Best for shared state across the entire application.
 
 ```tsx
 // 1. Initialize once
-import { initState } from 'argis'
+import { initState } from '@biglogic/rgs'
 initState({ namespace: 'app' })
 
 // 2. Use anywhere
@@ -237,7 +204,7 @@ Extend the core functionality dynamically with specialized modules.
 10. **GuardPlugin**: Data transformation layer.
 
 ```typescript
-import { createStore, PersistencePlugin, undoRedoPlugin } from 'argis'
+import { createStore, PersistencePlugin, undoRedoPlugin } from '@biglogic/rgs'
 
 const store = createStore()
 store._addPlugin(PersistencePlugin({ storage: 'localStorage' }))

package/{dist/markdown → markdown}/chapters/02-getting-started.md

@@ -15,7 +15,7 @@ npm install rgs
 In your main entry file (e.g., `main.tsx` or `App.tsx`), wake up the engine once.
 
 ```typescript
-import { initState } from 'argis';
+import { initState } from '@biglogic/rgs';
 
 // Initialize with optional settings
 initState({
@@ -29,7 +29,7 @@ initState({
 Use the `useStore` hook. No providers, no wrappers. Just raw, atomic power.
 
 ```tsx
-import { useStore } from 'argis';
+import { useStore } from '@biglogic/rgs';
 
 function Counter() {
   // If 'count' doesn't exist yet, it defaults to undefined. Easy.
@@ -57,7 +57,7 @@ function Counter() {
 Need to access state outside of React components? Simple.
 
 ```typescript
-import { getStore } from 'argis';
+import { getStore } from '@biglogic/rgs';
 
 const value = getStore()?.get('count');
 getStore()?.set('count', 9001);

package/{dist/markdown → markdown}/chapters/03-the-magnetar-way.md

@@ -9,7 +9,7 @@ It's a single function that creates the store and the hook simultaneously. **Zer
 Let's create a User Profile module.
 
 ```typescript
-import { gstate } from 'argis';
+import { gstate } from '@biglogic/rgs';
 
 // 1. Define the state and create everything in ONE shot
 export const useUser = gstate({

package/{dist/markdown → markdown}/chapters/04-persistence-and-safety.md

@@ -58,7 +58,7 @@ store.set('user', (draft) => {
 Never trust data coming back from the server or saved in the browser 6 months ago. Use the **schemaPlugin**.
 
 ```typescript
-import { schemaPlugin } from 'argis';
+import { schemaPlugin } from '@biglogic/rgs';
 import { z } from 'zod'; // Recommended!
 
 const store = initState();

package/{dist/markdown → markdown}/chapters/05-plugin-sdk.md

@@ -19,7 +19,7 @@ A plugin is a module that:
 Every plugin implements the `IPlugin` interface:
 
 ```typescript
-import type { IPlugin, PluginContext } from 'argis'
+import type { IPlugin, PluginContext } from '@biglogic/rgs'
 
 interface IPlugin {
   name: string
@@ -44,7 +44,7 @@ interface IPlugin {
 ### Example: A Simple Logger Plugin
 
 ```typescript
-import type { IPlugin, PluginContext } from 'argis'
+import type { IPlugin, PluginContext } from '@biglogic/rgs'
 
 export const loggerPlugin = (): IPlugin => {
   return {
@@ -74,7 +74,7 @@ store._addPlugin(loggerPlugin())
 Plugins can expose methods accessible via `store.plugins.pluginName.methodName()`:
 
 ```typescript
-import type { IPlugin, PluginContext } from 'argis'
+import type { IPlugin, PluginContext } from '@biglogic/rgs'
 
 export const counterPlugin = (): IPlugin => {
   let _count = 0
@@ -205,7 +205,7 @@ export const auditPlugin = (): IPlugin => {
 Here's a complete plugin that auto-saves to a custom backend:
 
 ```typescript
-import type { IPlugin, PluginContext } from 'argis'
+import type { IPlugin, PluginContext } from '@biglogic/rgs'
 
 interface AutoSaveConfig {
   endpoint: string

package/{dist/markdown → markdown}/chapters/05-plugins-and-extensibility.md

@@ -23,7 +23,7 @@ RGS includes 8 official plugins:
 Import the official plugin and you'll see every state change, transaction, and execution time in the console or dev tools (Redux DevTools support included!).
 
 ```typescript
-import { devToolsPlugin } from 'argis';
+import { devToolsPlugin } from '@biglogic/rgs';
 
 store._addPlugin(devToolsPlugin({ name: 'My Store' }));
 ```
@@ -35,7 +35,7 @@ store._addPlugin(devToolsPlugin({ name: 'My Store' }));
 Access your store directly from the browser console:
 
 ```typescript
-import { debugPlugin } from 'argis';
+import { debugPlugin } from '@biglogic/rgs';
 
 // Always wrap in dev check
 if (process.env.NODE_ENV === 'development') {
@@ -76,7 +76,7 @@ store.set('session_token', tokenValue, {
 ## 🎲 4. Undo/Redo: History Management
 
 ```typescript
-import { undoRedoPlugin } from 'argis';
+import { undoRedoPlugin } from '@biglogic/rgs';
 
 store._addPlugin(undoRedoPlugin({ limit: 50 }));
 
@@ -90,7 +90,7 @@ store.canRedo(); // boolean
 ## 📸 5. Snapshots: Save & Restore State
 
 ```typescript
-import { snapshotPlugin } from 'argis';
+import { snapshotPlugin } from '@biglogic/rgs';
 
 store._addPlugin(snapshotPlugin());
 
@@ -113,7 +113,7 @@ store.clearSnapshots();
 Transform values before they hit the store:
 
 ```typescript
-import { guardPlugin } from 'argis';
+import { guardPlugin } from '@biglogic/rgs';
 
 store._addPlugin(guardPlugin({
   'user_input': (val) => val.trim().toLowerCase()
@@ -125,7 +125,7 @@ store._addPlugin(guardPlugin({
 Validate values before setting:
 
 ```typescript
-import { schemaPlugin } from 'argis';
+import { schemaPlugin } from '@biglogic/rgs';
 
 store._addPlugin(schemaPlugin({
   'email': (val) => {
@@ -138,7 +138,7 @@ store._addPlugin(schemaPlugin({
 ## 📊 8. Analytics: Track Changes
 
 ```typescript
-import { analyticsPlugin } from 'argis';
+import { analyticsPlugin } from '@biglogic/rgs';
 
 store._addPlugin(analyticsPlugin({
   provider: (event) => {
@@ -152,7 +152,7 @@ store._addPlugin(analyticsPlugin({
 ## 🔄 9. Immer Integration
 
 ```typescript
-import { immerPlugin } from 'argis';
+import { immerPlugin } from '@biglogic/rgs';
 
 store._addPlugin(immerPlugin());
 

package/{dist/markdown → markdown}/chapters/08-migration-guide.md

@@ -58,7 +58,7 @@ const decoded = JSON.parse(atob(encoded)) // { secret: 'password123' }
 #### Example: Custom Error Logging
 
 ```typescript
-import { initState } from 'argis'
+import { initState } from '@biglogic/rgs'
 
 const store = initState({
   namespace: 'myapp',
@@ -98,7 +98,7 @@ interface ErrorContext {
 #### Example: Custom Size Limit
 
 ```typescript
-import { createStore } from 'argis'
+import { createStore } from '@biglogic/rgs'
 
 const store = createStore({
   maxObjectSize: 10 * 1024 * 1024, // 10MB limit
@@ -134,7 +134,7 @@ In previous versions, security rules were shared globally. Now, each store insta
 #### ❌ Deprecated Global Methods
 
 ```typescript
-import { addAccessRule, recordConsent } from 'argis'
+import { addAccessRule, recordConsent } from '@biglogic/rgs'
 
 // ⚠️ DEPRECATED: These affect the 'default' store only and are less isolated
 addAccessRule('user_*', ['read', 'write'])

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@biglogic/rgs",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "Argis (RGS) - React Globo State: A react state everywhere made easy",
+  "deprecated": false,
+  "preferGlobal": true,
+  "type": "module",
   "keywords": [
     "rgs",
     "gstate",
@@ -18,31 +21,23 @@
   ],
   "license": "MIT",
   "author": "Dario Passariello",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./advanced": {
-      "types": "./dist/advanced.d.ts",
-      "default": "./dist/advanced.js"
+  "contributors": [
+    {
+      "name": "Dario Passariello",
+      "email": "dariopassariello@gmail.com",
+      "url": "https://dario.passariello.ca/"
     },
-    "./package.json": "./package.json"
-  },
+    {
+      "name": "Valeria Cala Scaglitta",
+      "email": "valeriacalascaglitta@gmail.com"
+    }
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
   "scripts": {
     "build": "tsc --emitDeclarationOnly --outDir dist && node ./esbuild.config.mjs",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config ./tests/jest/jest.config.ts",
-    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config ./tests/jest/jest.config.ts --watch",
-    "test:e2e": "playwright test --config ./tests/playwright/playwright.config.ts",
-    "type-check": "tsc --noEmit",
-    "npm:publish": "npm run build && npm publish --access=public",
-    "lint": "eslint . --ext .ts,.tsx --config tests/eslint/eslint.config.mjs"
+    "npm: pack": "npm run build && cd dist && npm pack",
+    "npm: publish": "npm run build && cd dist && npm publish --access=public"
   },
   "dependencies": {
     "immer": "^11.1.4"

package/dist/CODEOWNERS

@@ -1 +0,0 @@
-* @passariello

package/dist/CONTRIBUTING.md

@@ -1,65 +0,0 @@
-# Contributing to RGS (Argis) - React Globo State
-
-Thank you for your interest in contributing!
-
-## Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/dpassariello/rgs.git
-cd rgs
-
-# Install dependencies
-npm install
-
-# Run tests
-npm test
-
-# Run linter
-npm run lint
-
-# Build
-npm run build
-```
-
-## Code Style
-
-- Use TypeScript with strict mode
-- Follow ESLint rules
-- Add JSDoc comments for public APIs
-- Write tests for new features
-
-## Testing
-
-```bash
-# Run all tests
-npm test
-
-# Run tests in watch mode
-npm run test:watch
-
-# Run e2e tests
-npm run test:e2e
-```
-
-## Pull Request Process
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Make your changes
-4. Ensure tests pass: `npm test`
-5. Ensure linting passes: `npm run lint`
-6. Commit your changes
-7. Push to your fork
-8. Open a Pull Request
-
-## Release Process
-
-1. Update version in `package.json`
-2. Update CHANGELOG.md
-3. Create a release on GitHub
-4. NPM publish happens automatically via CI/CD
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.

package/dist/package.json

@@ -1,81 +0,0 @@
-{
-  "name": "@biglogic/rgs",
-  "version": "2.7.0",
-  "description": "Argis (RGS) - React Globo State: A react state everywhere made easy",
-  "keywords": [
-    "rgs",
-    "gstate",
-    "state-management",
-    "react",
-    "enterprise",
-    "hooks",
-    "global-state",
-    "immer",
-    "biglogic",
-    "persistence",
-    "react-globo-state",
-    "argis"
-  ],
-  "license": "MIT",
-  "author": "Dario Passariello",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./advanced": {
-      "types": "./dist/advanced.d.ts",
-      "default": "./dist/advanced.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc --emitDeclarationOnly --outDir dist && node ./esbuild.config.mjs",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config ./tests/jest/jest.config.ts",
-    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config ./tests/jest/jest.config.ts --watch",
-    "test:e2e": "playwright test --config ./tests/playwright/playwright.config.ts",
-    "type-check": "tsc --noEmit",
-    "npm:publish": "npm run build && npm publish --access=public",
-    "lint": "eslint . --ext .ts,.tsx --config tests/eslint/eslint.config.mjs"
-  },
-  "dependencies": {
-    "immer": "^11.1.4"
-  },
-  "peerDependencies": {
-    "react": ">=16.8.0",
-    "react-dom": ">=16.8.0"
-  },
-  "devDependencies": {
-    "@eslint/js": "10.0.1",
-    "@playwright/test": "1.58.2",
-    "@testing-library/dom": "10.4.1",
-    "@testing-library/jest-dom": "6.9.1",
-    "@testing-library/react": "16.3.2",
-    "@types/jest": "30.0.0",
-    "@types/node": "25.2.3",
-    "@types/react": "19.2.14",
-    "@types/react-dom": "19.2.3",
-    "@typescript-eslint/eslint-plugin": "^8.55.0",
-    "@typescript-eslint/parser": "^8.55.0",
-    "dphelper": "2.6.3",
-    "esbuild": "0.27.3",
-    "esbuild-plugin-copy": "2.1.1",
-    "eslint": "^10.0.0",
-    "eslint-plugin-react": "7.37.5",
-    "eslint-plugin-react-hooks": "7.0.1",
-    "jest": "30.2.0",
-    "jest-environment-jsdom": "30.2.0",
-    "react": "19.2.4",
-    "react-dom": "19.2.4",
-    "ts-jest": "29.4.6",
-    "tslib": "^2.8.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "8.55.0"
-  }
-}