fractostate 1.0.0 → 1.0.2

package/src/store.ts

@@ -1,324 +0,0 @@
-import type { FlowOptions } from "./types";
-
-/**
- * Fast & Secure Memory Vault
- * Ultra-performant in-memory store with deep cloning and batching
- * NO PERSISTENCE - Pure memory for maximum safety and speed
- */
-class SecureVault {
-  private vault = new Map<string, any>();
-  private initialValues = new Map<string, any>();
-  private listeners = new Map<string, Set<() => void>>();
-  private histories = new Map<string, CircularBuffer<any>>();
-  private redoStacks = new Map<string, any[]>();
-  private debounceTimers = new Map<string, number>();
-  private batchQueue = new Set<string>();
-  private batchScheduled = false;
-
-  constructor() {
-    this.setupSecureAccess();
-    this.setupAutoCleanup();
-  }
-
-  /**
-   * Protects the vault instance from global window inspection.
-   */
-  private setupSecureAccess() {
-    if (typeof window !== "undefined") {
-      Object.defineProperty(window, "__FRACTO_VAULT__", {
-        get: () => "🔒 Access Denied: Secure Memory Instance",
-        configurable: false,
-      });
-    }
-  }
-
-  /**
-   * Periodically cleans up orphaned listeners.
-   */
-  private setupAutoCleanup() {
-    if (typeof setInterval !== "undefined") {
-      setInterval(() => {
-        this.listeners.forEach((set, key) => {
-          if (set.size === 0 && !this.vault.has(key)) {
-            this.listeners.delete(key);
-          }
-        });
-      }, 300000); // 5 min
-    }
-  }
-
-  /**
-   * Lightweight but ultra-fast obfuscation for memory protection.
-   */
-  private obfuscate(data: any): any {
-    if (data === undefined) return undefined;
-    try {
-      const str = JSON.stringify(data);
-      // Simple scrambling to prevent plain-text memory inspection
-      return { _: btoa(encodeURIComponent(str)), t: Date.now() };
-    } catch {
-      return data;
-    }
-  }
-
-  /**
-   * Reverts obfuscation to retrieve original data structure.
-   */
-  private deobfuscate(vaultItem: any): any {
-    if (!vaultItem || typeof vaultItem !== "object" || !vaultItem._)
-      return vaultItem;
-    try {
-      const decoded = decodeURIComponent(atob(vaultItem._));
-      return JSON.parse(decoded);
-    } catch {
-      return undefined;
-    }
-  }
-
-  /**
-   * Retrieves state from the vault. Initializes if a value is provided and the key is missing.
-   */
-  get(key: string, initialValue?: any) {
-    if (!this.vault.has(key)) {
-      if (initialValue === undefined) return undefined;
-
-      const cloned = deepClone(initialValue);
-      this.vault.set(key, this.obfuscate(cloned));
-      this.initialValues.set(key, deepClone(cloned));
-      this.histories.set(key, new CircularBuffer(100, [cloned]));
-      this.redoStacks.set(key, []);
-    }
-
-    const val = this.deobfuscate(this.vault.get(key));
-    return val === undefined ? initialValue : val;
-  }
-
-  /**
-   * Updates state in the vault with optional debouncing and middleware support.
-   */
-  set(key: string, newValue: any, options: FlowOptions = {}) {
-    const prevState = this.deobfuscate(this.vault.get(key));
-    let stateToSet = deepClone(newValue);
-
-    // Apply synchronous middleware
-    if (options.middleware) {
-      for (const fn of options.middleware) {
-        stateToSet = fn(stateToSet);
-      }
-    }
-
-    // Skip update if state has not changed (Deep equality check)
-    if (deepEqual(prevState, stateToSet)) return;
-
-    if (options.debounce) {
-      this.debouncedSet(key, stateToSet, options);
-      return;
-    }
-
-    this.applySet(key, stateToSet, options);
-  }
-
-  /**
-   * Executes a debounced state update.
-   */
-  private debouncedSet(key: string, value: any, options: FlowOptions) {
-    const existing = this.debounceTimers.get(key);
-    if (existing) clearTimeout(existing);
-
-    const timer = setTimeout(() => {
-      this.applySet(key, value, options);
-      this.debounceTimers.delete(key);
-    }, options.debounce);
-
-    this.debounceTimers.set(key, timer as any);
-  }
-
-  /**
-   * Core logic for applying a state update and managing history.
-   */
-  private applySet(key: string, stateToSet: any, options: FlowOptions) {
-    this.vault.set(key, this.obfuscate(stateToSet));
-
-    if (options.timeTravel) {
-      const history = this.histories.get(key);
-      if (history) history.push(deepClone(stateToSet));
-      const redo = this.redoStacks.get(key);
-      if (redo) redo.length = 0;
-    }
-
-    this.scheduleBatchNotify(key);
-  }
-
-  /**
-   * Schedules a microtask to batch notifications and optimize React renders.
-   */
-  private scheduleBatchNotify(key: string) {
-    this.batchQueue.add(key);
-    if (this.batchScheduled) return;
-    this.batchScheduled = true;
-    queueMicrotask(() => this.flushBatchNotify());
-  }
-
-  /**
-   * Flushes and notifies all queued listeners.
-   */
-  private flushBatchNotify() {
-    const keys = Array.from(this.batchQueue);
-    this.batchQueue.clear();
-    this.batchScheduled = false;
-    keys.forEach((key) => this.notify(key));
-  }
-
-  /**
-   * Connects a listener to a specific flow key.
-   */
-  subscribe(key: string, listener: () => void) {
-    if (!this.listeners.has(key)) this.listeners.set(key, new Set());
-    this.listeners.get(key)!.add(listener);
-    return () => {
-      this.listeners.get(key)?.delete(listener);
-    };
-  }
-
-  /**
-   * Directly notifies all listeners of a specific key.
-   */
-  private notify(key: string) {
-    this.listeners.get(key)?.forEach((l) => l());
-  }
-
-  /**
-   * Reverts the state to the previous version in history.
-   */
-  undo(key: string) {
-    const history = this.histories.get(key);
-    const redo = this.redoStacks.get(key);
-    if (history && history.length() > 1) {
-      const current = history.pop();
-      if (current) redo?.push(current);
-      const prev = history.peek();
-      this.vault.set(key, this.obfuscate(prev));
-      this.notify(key);
-    }
-  }
-
-  /**
-   * Restores the state to the next version in the redo stack.
-   */
-  redo(key: string) {
-    const history = this.histories.get(key);
-    const redo = this.redoStacks.get(key);
-    if (redo && redo.length > 0) {
-      const next = redo.pop();
-      history?.push(next);
-      this.vault.set(key, this.obfuscate(next));
-      this.notify(key);
-    }
-  }
-
-  /**
-   * Resets a flow to its initial value.
-   */
-  reset(key: string) {
-    const initial = this.initialValues.get(key);
-    if (initial !== undefined) this.set(key, initial);
-  }
-
-  getHistory(key: string) {
-    return this.histories.get(key)?.toArray() || [];
-  }
-  getRedoStack(key: string) {
-    return this.redoStacks.get(key) || [];
-  }
-
-  /**
-   * Clears the entire store and all timers.
-   */
-  clearAll() {
-    this.debounceTimers.forEach((t) => clearTimeout(t));
-    this.vault.clear();
-    this.initialValues.clear();
-    this.listeners.clear();
-    this.histories.clear();
-    this.redoStacks.clear();
-  }
-}
-
-/**
- * Circular Buffer implementation for high-performance memory-efficient history.
- */
-class CircularBuffer<T> {
-  private buffer: T[];
-  private head = 0;
-  private size = 0;
-  private maxSize: number;
-
-  constructor(maxSize: number, initial: T[] = []) {
-    this.maxSize = maxSize;
-    this.buffer = new Array(maxSize);
-    initial.forEach((i) => this.push(i));
-  }
-  push(item: T) {
-    this.buffer[this.head] = item;
-    this.head = (this.head + 1) % this.maxSize;
-    if (this.size < this.maxSize) this.size++;
-  }
-  pop(): T | undefined {
-    if (this.size <= 0) return undefined;
-    this.head = (this.head - 1 + this.maxSize) % this.maxSize;
-    this.size--;
-    return this.buffer[this.head];
-  }
-  peek(): T | undefined {
-    return this.size > 0
-      ? this.buffer[(this.head - 1 + this.maxSize) % this.maxSize]
-      : undefined;
-  }
-  length() {
-    return this.size;
-  }
-  toArray(): T[] {
-    const res = [];
-    for (let i = 0; i < this.size; i++) {
-      res.push(
-        this.buffer[(this.head - this.size + i + this.maxSize) % this.maxSize],
-      );
-    }
-    return res;
-  }
-}
-
-/**
- * High-performance deep cloning utility.
- */
-function deepClone<T>(obj: T): T {
-  if (obj === null || typeof obj !== "object") return obj;
-  if (Array.isArray(obj)) return obj.map(deepClone) as any;
-  const cloned: any = {};
-  for (const key in obj) {
-    if (Object.prototype.hasOwnProperty.call(obj, key))
-      cloned[key] = deepClone(obj[key]);
-  }
-  return cloned;
-}
-
-/**
- * High-performance deep equality utility.
- */
-function deepEqual(a: any, b: any): boolean {
-  if (a === b) return true;
-  if (typeof a !== typeof b || a === null || b === null) return false;
-  if (typeof a === "object") {
-    const keysA = Object.keys(a);
-    const keysB = Object.keys(b);
-    if (keysA.length !== keysB.length) return false;
-    for (const key of keysA) {
-      if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
-      if (!deepEqual(a[key], b[key])) return false;
-    }
-    return true;
-  }
-  return false;
-}
-
-export const store = new SecureVault();

package/src/types.ts

@@ -1,126 +0,0 @@
-export interface FlowOptions<T = any> {
-  /** Enable history tracking for undo/redo functionality */
-  timeTravel?: boolean;
-  /** Maximum number of states to keep in history (default: 100) */
-  maxHistory?: number;
-  /** Debounce state updates in milliseconds */
-  debounce?: number;
-  /** Array of functions to transform state before it is saved */
-  middleware?: Array<(state: T) => T>;
-}
-
-export type BaseOps<T> = {
-  /** Replaces the entire value at this path */
-  set: (value: T) => void;
-};
-
-export type NumberOps = BaseOps<number> & {
-  /** Adds 1 (or amount) to the number */
-  increment: (amount?: number) => void;
-  /** Subtracts 1 (or amount) from the number */
-  decrement: (amount?: number) => void;
-  /** Adds the given amount */
-  add: (amount: number) => void;
-  /** Subtracts the given amount */
-  subtract: (amount: number) => void;
-  /** Multiplies by the given amount */
-  multiply: (amount: number) => void;
-  /** Divides by the given amount */
-  divide: (amount: number) => void;
-};
-
-export type StringOps = BaseOps<string> & {
-  /** Appends a string to the end */
-  append: (str: string) => void;
-  /** Prepends a string to the beginning */
-  prepend: (str: string) => void;
-  /** Converts to uppercase */
-  uppercase: () => void;
-  /** Converts to lowercase */
-  lowercase: () => void;
-  /** Removes whitespace from both ends */
-  trim: () => void;
-  /** Replaces a substring or regex match */
-  replace: (search: string | RegExp, replace: string) => void;
-};
-
-export type ArrayOps<T> = BaseOps<T[]> & {
-  /** Appends an item to the end */
-  push: (item: T) => void;
-  /** Removes the last item */
-  pop: () => void;
-  /** Removes the first item */
-  shift: () => void;
-  /** Adds an item to the beginning */
-  unshift: (item: T) => void;
-  /** Filters the array based on a predicate */
-  filter: (predicate: (item: T, index: number) => boolean) => void;
-  /** Transforms each item in the array */
-  map: (fn: (item: T, index: number) => T) => void;
-  /** Adds/removes items at a specific index */
-  splice: (start: number, deleteCount?: number, ...items: T[]) => void;
-  /** Removes the item at the specified index */
-  removeAt: (index: number) => void;
-  /** Inserts an item at the specified index */
-  insertAt: (index: number, item: T) => void;
-};
-
-export type ObjectOps<T> = BaseOps<T> & {
-  /** Merges the given object into the current one */
-  merge: (partial: Partial<T>) => void;
-  /** Deletes a property from the object */
-  delete: (key: keyof T) => void;
-} & {
-  /** Recursive access to nested properties */
-  [K in keyof T]-?: TypeAwareOps<T[K]>;
-};
-
-export type BooleanOps = BaseOps<boolean> & {
-  /** Inverts the current boolean value */
-  toggle: () => void;
-};
-
-export type TypeAwareOps<T> = T extends number
-  ? NumberOps
-  : T extends string
-    ? StringOps
-    : T extends boolean
-      ? BooleanOps
-      : T extends Array<infer U>
-        ? ArrayOps<U>
-        : T extends object
-          ? ObjectOps<T>
-          : BaseOps<T>;
-
-export interface FlowDefinition<T> {
-  key: string;
-  initial: T;
-  options?: FlowOptions<T>;
-}
-
-export interface FlowOperations<T> {
-  ops: {
-    /**
-     * Recursive, type-aware proxy that provides surgical atomic operations
-     * tailored to the shape of your state. It allows direct-like manipulation
-     * that is internally processed as immutable updates.
-     */
-    self: TypeAwareOps<T>;
-  };
-  /** Reverts to the previous state in history */
-  undo: () => void;
-  /** Restores the previously undone state */
-  redo: () => void;
-  /** Array of past states (requires timeTravel: true) */
-  history: T[];
-  /** Whether there is a previous state to undo */
-  canUndo: boolean;
-  /** Whether there is a next state to redo */
-  canRedo: boolean;
-  /** Manually sets the entire state or applies a transformation function */
-  set: (val: T | ((prev: T) => T)) => void;
-  /** Restores the state to its initial value */
-  reset: () => void;
-  /** Current flow configuration options */
-  cf: FlowOptions<T>;
-}

package/test/README.md

@@ -1,73 +0,0 @@
-# React + TypeScript + Vite
-
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
-
-Currently, two official plugins are available:
-
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
-
-## React Compiler
-
-The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
-
-## Expanding the ESLint configuration
-
-If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
-
-```js
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-
-      // Remove tseslint.configs.recommended and replace with this
-      tseslint.configs.recommendedTypeChecked,
-      // Alternatively, use this for stricter rules
-      tseslint.configs.strictTypeChecked,
-      // Optionally, add this for stylistic rules
-      tseslint.configs.stylisticTypeChecked,
-
-      // Other configs...
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```
-
-You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
-
-```js
-// eslint.config.js
-import reactX from 'eslint-plugin-react-x'
-import reactDom from 'eslint-plugin-react-dom'
-
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-      // Enable lint rules for React
-      reactX.configs['recommended-typescript'],
-      // Enable lint rules for React DOM
-      reactDom.configs.recommended,
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```

package/test/eslint.config.js

@@ -1,23 +0,0 @@
-import js from '@eslint/js'
-import globals from 'globals'
-import reactHooks from 'eslint-plugin-react-hooks'
-import reactRefresh from 'eslint-plugin-react-refresh'
-import tseslint from 'typescript-eslint'
-import { defineConfig, globalIgnores } from 'eslint/config'
-
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      js.configs.recommended,
-      tseslint.configs.recommended,
-      reactHooks.configs.flat.recommended,
-      reactRefresh.configs.vite,
-    ],
-    languageOptions: {
-      ecmaVersion: 2020,
-      globals: globals.browser,
-    },
-  },
-])

package/test/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>test</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/test/package.json

@@ -1,47 +0,0 @@
-{
-  "dependencies": {
-    "@eslint/js": "9.39.2",
-    "@tailwindcss/postcss": "^4.1.18",
-    "@types/node": "24.10.9",
-    "@types/react": "19.2.9",
-    "@types/react-dom": "19.2.3",
-    "@vitejs/plugin-react": "5.1.2",
-    "autoprefixer": "^10.4.23",
-    "eslint": "9.39.2",
-    "eslint-plugin-react-hooks": "7.0.1",
-    "eslint-plugin-react-refresh": "0.4.26",
-    "globals": "16.5.0",
-    "postcss": "^8.5.6",
-    "react": "19.2.3",
-    "react-dom": "19.2.3",
-    "sql.js": "^1.13.0",
-    "tailwindcss": "^4.1.18",
-    "typescript": "5.9.3",
-    "typescript-eslint": "8.53.1",
-    "vite": "7.3.1"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.5",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
-    "eslint": "^9.39.1",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    "globals": "^16.5.0",
-    "typescript": "~5.9.3",
-    "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.4"
-  },
-  "name": "test",
-  "private": true,
-  "scripts": {
-    "build": "tsc -b && vite build",
-    "dev": "vite",
-    "lint": "eslint .",
-    "preview": "vite preview"
-  },
-  "type": "module",
-  "version": "0.0.0"
-}

package/test/postcss.config.mjs

@@ -1,7 +0,0 @@
-const config = {
-  plugins: {
-    "@tailwindcss/postcss": {},
-  },
-};
-
-export default config;

package/test/public/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/test/src/App.css

@@ -1,42 +0,0 @@
-#root {
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 2rem;
-  text-align: center;
-}
-
-.logo {
-  height: 6em;
-  padding: 1.5em;
-  will-change: filter;
-  transition: filter 300ms;
-}
-.logo:hover {
-  filter: drop-shadow(0 0 2em #646cffaa);
-}
-.logo.react:hover {
-  filter: drop-shadow(0 0 2em #61dafbaa);
-}
-
-@keyframes logo-spin {
-  from {
-    transform: rotate(0deg);
-  }
-  to {
-    transform: rotate(360deg);
-  }
-}
-
-@media (prefers-reduced-motion: no-preference) {
-  a:nth-of-type(2) .logo {
-    animation: logo-spin infinite 20s linear;
-  }
-}
-
-.card {
-  padding: 2em;
-}
-
-.read-the-docs {
-  color: #888;
-}