@coherent.js/state 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/state-validation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/state-validation.js"],
+  "sourcesContent": ["/**\n * @fileoverview State Validation for Coherent.js\n * Provides JSON Schema validation and custom validators for state management\n * @module @coherent.js/core/state/state-validation\n */\n\n/**\n * @typedef {Object} ValidationOptions\n * @property {Object} [schema] - JSON Schema for validation\n * @property {Object<string, Function>} [validators] - Custom validator functions\n * @property {boolean} [strict=false] - Strict mode (throw on validation errors)\n * @property {boolean} [coerce=false] - Coerce types to match schema\n * @property {Function} [onError] - Validation error callback\n * @property {boolean} [validateOnSet=true] - Validate on state updates\n * @property {boolean} [validateOnGet=false] - Validate on state reads\n * @property {Array<string>} [required] - Required fields\n * @property {boolean} [allowUnknown=true] - Allow unknown properties\n */\n\n/**\n * @typedef {Object} ValidationResult\n * @property {boolean} valid - Whether validation passed\n * @property {Array<ValidationError>} errors - Array of validation errors\n * @property {*} value - Validated/coerced value\n */\n\n/**\n * @typedef {Object} ValidationError\n * @property {string} path - Property path that failed validation\n * @property {string} message - Error message\n * @property {string} type - Error type\n * @property {*} value - The invalid value\n * @property {*} expected - Expected value/type\n */\n\n/**\n * Simple JSON Schema validator\n */\nclass SchemaValidator {\n  constructor(schema, options = {}) {\n    this.schema = schema;\n    this.options = {\n      coerce: false,\n      allowUnknown: true,\n      ...options\n    };\n  }\n\n  /**\n   * Validate value against schema\n   * @param {*} value - Value to validate\n   * @param {Object} schema - Schema to validate against\n   * @param {string} path - Current path in object\n   * @returns {ValidationResult} Validation result\n   */\n  validate(value, schema = this.schema, path = '') {\n    const errors = [];\n    let coercedValue = value;\n\n    // Type validation\n    if (schema.type) {\n      const typeResult = this.validateType(value, schema.type, path);\n      if (!typeResult.valid) {\n        errors.push(...typeResult.errors);\n        if (!this.options.coerce) {\n          return { valid: false, errors, value };\n        }\n      }\n      coercedValue = typeResult.value;\n    }\n\n    // Enum validation\n    if (schema.enum) {\n      const enumResult = this.validateEnum(coercedValue, schema.enum, path);\n      if (!enumResult.valid) {\n        errors.push(...enumResult.errors);\n      }\n    }\n\n    // String validations\n    if (schema.type === 'string') {\n      const stringResult = this.validateString(coercedValue, schema, path);\n      if (!stringResult.valid) {\n        errors.push(...stringResult.errors);\n      }\n    }\n\n    // Number validations\n    if (schema.type === 'number' || schema.type === 'integer') {\n      const numberResult = this.validateNumber(coercedValue, schema, path);\n      if (!numberResult.valid) {\n        errors.push(...numberResult.errors);\n      }\n    }\n\n    // Array validations\n    if (schema.type === 'array') {\n      const arrayResult = this.validateArray(coercedValue, schema, path);\n      if (!arrayResult.valid) {\n        errors.push(...arrayResult.errors);\n      }\n      coercedValue = arrayResult.value;\n    }\n\n    // Object validations\n    if (schema.type === 'object') {\n      const objectResult = this.validateObject(coercedValue, schema, path);\n      if (!objectResult.valid) {\n        errors.push(...objectResult.errors);\n      }\n      coercedValue = objectResult.value;\n    }\n\n    // Custom validation function\n    if (schema.validate && typeof schema.validate === 'function') {\n      const customResult = schema.validate(coercedValue);\n      if (customResult !== true) {\n        errors.push({\n          path,\n          message: typeof customResult === 'string' ? customResult : 'Custom validation failed',\n          type: 'custom',\n          value: coercedValue\n        });\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n      value: coercedValue\n    };\n  }\n\n  validateType(value, type, path) {\n    const actualType = Array.isArray(value) ? 'array' : typeof value;\n    const errors = [];\n    let coercedValue = value;\n\n    // Support array of types\n    const types = Array.isArray(type) ? type : [type];\n\n    const isValid = types.some(t => {\n      if (t === 'array') return Array.isArray(value);\n      if (t === 'null') return value === null;\n      if (t === 'integer') return typeof value === 'number' && Number.isInteger(value);\n      return typeof value === t;\n    });\n\n    if (!isValid) {\n      if (this.options.coerce) {\n        // Try to coerce\n        const primaryType = types[0];\n        try {\n          if (primaryType === 'string') {\n            coercedValue = String(value);\n          } else if (primaryType === 'number') {\n            coercedValue = Number(value);\n            if (isNaN(coercedValue)) {\n              errors.push({\n                path,\n                message: `Cannot coerce \"${value}\" to number`,\n                type: 'type',\n                value,\n                expected: primaryType\n              });\n            }\n          } else if (primaryType === 'boolean') {\n            coercedValue = Boolean(value);\n          } else if (primaryType === 'integer') {\n            coercedValue = parseInt(value, 10);\n            if (isNaN(coercedValue)) {\n              errors.push({\n                path,\n                message: `Cannot coerce \"${value}\" to integer`,\n                type: 'type',\n                value,\n                expected: primaryType\n              });\n            }\n          }\n        } catch {\n          errors.push({\n            path,\n            message: `Cannot coerce value to ${primaryType}`,\n            type: 'type',\n            value,\n            expected: primaryType\n          });\n        }\n      } else {\n        errors.push({\n          path,\n          message: `Expected type ${types.join(' or ')}, got ${actualType}`,\n          type: 'type',\n          value,\n          expected: type\n        });\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n      value: coercedValue\n    };\n  }\n\n  validateEnum(value, enumValues, path) {\n    const errors = [];\n    if (!enumValues.includes(value)) {\n      errors.push({\n        path,\n        message: `Value must be one of: ${enumValues.join(', ')}`,\n        type: 'enum',\n        value,\n        expected: enumValues\n      });\n    }\n    return { valid: errors.length === 0, errors };\n  }\n\n  validateString(value, schema, path) {\n    const errors = [];\n\n    if (schema.minLength !== undefined && value.length < schema.minLength) {\n      errors.push({\n        path,\n        message: `String length must be >= ${schema.minLength}`,\n        type: 'minLength',\n        value\n      });\n    }\n\n    if (schema.maxLength !== undefined && value.length > schema.maxLength) {\n      errors.push({\n        path,\n        message: `String length must be <= ${schema.maxLength}`,\n        type: 'maxLength',\n        value\n      });\n    }\n\n    if (schema.pattern) {\n      const regex = new RegExp(schema.pattern);\n      if (!regex.test(value)) {\n        errors.push({\n          path,\n          message: `String does not match pattern: ${schema.pattern}`,\n          type: 'pattern',\n          value\n        });\n      }\n    }\n\n    if (schema.format) {\n      const formatResult = this.validateFormat(value, schema.format, path);\n      if (!formatResult.valid) {\n        errors.push(...formatResult.errors);\n      }\n    }\n\n    return { valid: errors.length === 0, errors };\n  }\n\n  validateFormat(value, format, path) {\n    const errors = [];\n    const formats = {\n      email: /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/,\n      url: /^https?:\\/\\/.+/,\n      uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,\n      date: /^\\d{4}-\\d{2}-\\d{2}$/,\n      'date-time': /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/\n    };\n\n    if (formats[format] && !formats[format].test(value)) {\n      errors.push({\n        path,\n        message: `String does not match format: ${format}`,\n        type: 'format',\n        value,\n        expected: format\n      });\n    }\n\n    return { valid: errors.length === 0, errors };\n  }\n\n  validateNumber(value, schema, path) {\n    const errors = [];\n\n    if (schema.minimum !== undefined && value < schema.minimum) {\n      errors.push({\n        path,\n        message: `Number must be >= ${schema.minimum}`,\n        type: 'minimum',\n        value\n      });\n    }\n\n    if (schema.maximum !== undefined && value > schema.maximum) {\n      errors.push({\n        path,\n        message: `Number must be <= ${schema.maximum}`,\n        type: 'maximum',\n        value\n      });\n    }\n\n    if (schema.exclusiveMinimum !== undefined && value <= schema.exclusiveMinimum) {\n      errors.push({\n        path,\n        message: `Number must be > ${schema.exclusiveMinimum}`,\n        type: 'exclusiveMinimum',\n        value\n      });\n    }\n\n    if (schema.exclusiveMaximum !== undefined && value >= schema.exclusiveMaximum) {\n      errors.push({\n        path,\n        message: `Number must be < ${schema.exclusiveMaximum}`,\n        type: 'exclusiveMaximum',\n        value\n      });\n    }\n\n    if (schema.multipleOf !== undefined && value % schema.multipleOf !== 0) {\n      errors.push({\n        path,\n        message: `Number must be multiple of ${schema.multipleOf}`,\n        type: 'multipleOf',\n        value\n      });\n    }\n\n    return { valid: errors.length === 0, errors };\n  }\n\n  validateArray(value, schema, path) {\n    const errors = [];\n    const coercedValue = [...value];\n\n    if (schema.minItems !== undefined && value.length < schema.minItems) {\n      errors.push({\n        path,\n        message: `Array must have at least ${schema.minItems} items`,\n        type: 'minItems',\n        value\n      });\n    }\n\n    if (schema.maxItems !== undefined && value.length > schema.maxItems) {\n      errors.push({\n        path,\n        message: `Array must have at most ${schema.maxItems} items`,\n        type: 'maxItems',\n        value\n      });\n    }\n\n    if (schema.uniqueItems) {\n      const seen = new Set();\n      const duplicates = [];\n      value.forEach((item, index) => {\n        const key = JSON.stringify(item);\n        if (seen.has(key)) {\n          duplicates.push(index);\n        }\n        seen.add(key);\n      });\n      if (duplicates.length > 0) {\n        errors.push({\n          path,\n          message: 'Array items must be unique',\n          type: 'uniqueItems',\n          value\n        });\n      }\n    }\n\n    // Validate items\n    if (schema.items) {\n      value.forEach((item, index) => {\n        const itemPath = `${path}[${index}]`;\n        const itemResult = this.validate(item, schema.items, itemPath);\n        if (!itemResult.valid) {\n          errors.push(...itemResult.errors);\n        }\n        if (this.options.coerce) {\n          coercedValue[index] = itemResult.value;\n        }\n      });\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n      value: coercedValue\n    };\n  }\n\n  validateObject(value, schema, path) {\n    const errors = [];\n    const coercedValue = { ...value };\n\n    // Required properties\n    if (schema.required) {\n      schema.required.forEach(prop => {\n        if (!(prop in value)) {\n          errors.push({\n            path: path ? `${path}.${prop}` : prop,\n            message: `Required property \"${prop}\" is missing`,\n            type: 'required',\n            value: undefined\n          });\n        }\n      });\n    }\n\n    // Validate properties\n    if (schema.properties) {\n      Object.entries(schema.properties).forEach(([prop, propSchema]) => {\n        if (prop in value) {\n          const propPath = path ? `${path}.${prop}` : prop;\n          const propResult = this.validate(value[prop], propSchema, propPath);\n          if (!propResult.valid) {\n            errors.push(...propResult.errors);\n          }\n          if (this.options.coerce) {\n            coercedValue[prop] = propResult.value;\n          }\n        }\n      });\n    }\n\n    // Additional properties\n    if (schema.additionalProperties === false && !this.options.allowUnknown) {\n      const allowedProps = new Set(Object.keys(schema.properties || {}));\n      Object.keys(value).forEach(prop => {\n        if (!allowedProps.has(prop)) {\n          errors.push({\n            path: path ? `${path}.${prop}` : prop,\n            message: `Unknown property \"${prop}\"`,\n            type: 'additionalProperties',\n            value: value[prop]\n          });\n        }\n      });\n    }\n\n    // Min/max properties\n    const propCount = Object.keys(value).length;\n    if (schema.minProperties !== undefined && propCount < schema.minProperties) {\n      errors.push({\n        path,\n        message: `Object must have at least ${schema.minProperties} properties`,\n        type: 'minProperties',\n        value\n      });\n    }\n\n    if (schema.maxProperties !== undefined && propCount > schema.maxProperties) {\n      errors.push({\n        path,\n        message: `Object must have at most ${schema.maxProperties} properties`,\n        type: 'maxProperties',\n        value\n      });\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n      value: coercedValue\n    };\n  }\n}\n\n/**\n * Create validated state manager\n * @param {Object} initialState - Initial state\n * @param {ValidationOptions} options - Validation options\n * @returns {Object} Validated state manager\n */\nexport function createValidatedState(initialState = {}, options = {}) {\n  const opts = {\n    schema: null,\n    validators: {},\n    strict: false,\n    coerce: false,\n    onError: null,\n    validateOnSet: true,\n    validateOnGet: false,\n    required: [],\n    allowUnknown: true,\n    ...options\n  };\n\n  const schemaValidator = opts.schema ? new SchemaValidator(opts.schema, {\n    coerce: opts.coerce,\n    allowUnknown: opts.allowUnknown\n  }) : null;\n\n  let state = { ...initialState };\n  const listeners = new Set();\n  const validationErrors = new Map();\n\n  /**\n   * Validate state\n   * @param {Object} value - State to validate\n   * @param {string} key - State key (for partial validation)\n   * @returns {ValidationResult} Validation result\n   */\n  function validateState(value, key = null) {\n    const errors = [];\n    let validatedValue = value;\n\n    // JSON Schema validation\n    if (schemaValidator) {\n      const schema = key && opts.schema.properties\n        ? opts.schema.properties[key]\n        : opts.schema;\n\n      const result = schemaValidator.validate(value, schema, key || '');\n      if (!result.valid) {\n        errors.push(...result.errors);\n      }\n      validatedValue = result.value;\n    }\n\n    // Custom validators\n    if (key && opts.validators[key]) {\n      const validator = opts.validators[key];\n      const result = validator(value);\n      if (result !== true) {\n        errors.push({\n          path: key,\n          message: typeof result === 'string' ? result : 'Validation failed',\n          type: 'custom',\n          value\n        });\n      }\n    } else if (!key) {\n      // Run custom validators for all fields when validating full state\n      Object.entries(opts.validators).forEach(([fieldKey, validator]) => {\n        if (fieldKey in value) {\n          const result = validator(value[fieldKey]);\n          if (result !== true) {\n            errors.push({\n              path: fieldKey,\n              message: typeof result === 'string' ? result : 'Validation failed',\n              type: 'custom',\n              value: value[fieldKey]\n            });\n          }\n        }\n      });\n    }\n\n    // Required fields\n    if (opts.required.length > 0 && !key) {\n      opts.required.forEach(field => {\n        if (!(field in value)) {\n          errors.push({\n            path: field,\n            message: `Required field \"${field}\" is missing`,\n            type: 'required',\n            value: undefined\n          });\n        }\n      });\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n      value: validatedValue\n    };\n  }\n\n  /**\n   * Get state\n   * @param {string} key - State key\n   * @returns {*} State value\n   */\n  function getState(key) {\n    const value = key ? state[key] : { ...state };\n\n    if (opts.validateOnGet) {\n      const result = validateState(value, key);\n      if (!result.valid) {\n        validationErrors.set(key || '__root__', result.errors);\n        if (opts.onError) {\n          opts.onError(result.errors);\n        }\n      }\n    }\n\n    return value;\n  }\n\n  /**\n   * Set state\n   * @param {Object|Function} updates - State updates\n   * @throws {Error} If validation fails in strict mode\n   */\n  function setState(updates) {\n    const oldState = { ...state };\n\n    if (typeof updates === 'function') {\n      updates = updates(oldState);\n    }\n\n    // Create the new full state for validation\n    const newState = { ...state, ...updates };\n\n    // Validate before setting\n    if (opts.validateOnSet) {\n      const result = validateState(newState);\n\n      if (!result.valid) {\n        validationErrors.set('__root__', result.errors);\n\n        if (opts.onError) {\n          opts.onError(result.errors);\n        }\n\n        if (opts.strict) {\n          const error = new Error('Validation failed');\n          error.validationErrors = result.errors;\n          throw error;\n        }\n\n        // Don't update state if validation fails in non-strict mode\n        return;\n      }\n\n      // Use coerced value if coercion is enabled\n      if (opts.coerce) {\n        const updatedKeys = Object.keys(updates);\n        const newUpdates = {};\n        updatedKeys.forEach(key => {\n          if (result.value[key] !== state[key]) {\n            newUpdates[key] = result.value[key];\n          }\n        });\n        updates = newUpdates;\n      }\n\n      // Clear errors on successful validation\n      validationErrors.clear();\n    }\n\n    state = { ...state, ...updates };\n\n    // Notify listeners\n    listeners.forEach(listener => {\n      try {\n        listener(state, oldState);\n      } catch (error) {\n        console.error('Listener error:', error);\n      }\n    });\n  }\n\n  /**\n   * Subscribe to state changes\n   * @param {Function} listener - Change listener\n   * @returns {Function} Unsubscribe function\n   */\n  function subscribe(listener) {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  }\n\n  /**\n   * Get validation errors\n   * @param {string} key - State key\n   * @returns {Array<ValidationError>} Validation errors\n   */\n  function getErrors(key = '__root__') {\n    return validationErrors.get(key) || [];\n  }\n\n  /**\n   * Check if state is valid\n   * @returns {boolean} Whether state is valid\n   */\n  function isValid() {\n    const result = validateState(state);\n    if (!result.valid) {\n      validationErrors.set('__root__', result.errors);\n    }\n    return result.valid;\n  }\n\n  /**\n   * Validate specific field\n   * @param {string} key - Field key\n   * @param {*} value - Field value\n   * @returns {ValidationResult} Validation result\n   */\n  function validateField(key, value) {\n    return validateState(value, key);\n  }\n\n  return {\n    getState,\n    setState,\n    subscribe,\n    getErrors,\n    isValid,\n    validateField,\n    validate: () => validateState(state)\n  };\n}\n\n/**\n * Common validators\n */\nexport const validators = {\n  /**\n   * Email validator\n   * @param {string} value - Email to validate\n   * @returns {boolean|string} True if valid, error message otherwise\n   */\n  email: (value) => {\n    if (typeof value !== 'string') return 'Email must be a string';\n    if (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value)) return 'Invalid email format';\n    return true;\n  },\n\n  /**\n   * URL validator\n   * @param {string} value - URL to validate\n   * @returns {boolean|string} True if valid, error message otherwise\n   */\n  url: (value) => {\n    if (typeof value !== 'string') return 'URL must be a string';\n    try {\n      new URL(value);\n      return true;\n    } catch {\n      return 'Invalid URL format';\n    }\n  },\n\n  /**\n   * Range validator\n   * @param {number} min - Minimum value\n   * @param {number} max - Maximum value\n   * @returns {Function} Validator function\n   */\n  range: (min, max) => (value) => {\n    if (typeof value !== 'number') return 'Value must be a number';\n    if (value < min || value > max) return `Value must be between ${min} and ${max}`;\n    return true;\n  },\n\n  /**\n   * Length validator\n   * @param {number} min - Minimum length\n   * @param {number} max - Maximum length\n   * @returns {Function} Validator function\n   */\n  length: (min, max) => (value) => {\n    if (typeof value !== 'string') return 'Value must be a string';\n    if (value.length < min || value.length > max) {\n      return `Length must be between ${min} and ${max}`;\n    }\n    return true;\n  },\n\n  /**\n   * Pattern validator\n   * @param {RegExp|string} pattern - Pattern to match\n   * @returns {Function} Validator function\n   */\n  pattern: (pattern) => (value) => {\n    if (typeof value !== 'string') return 'Value must be a string';\n    const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;\n    if (!regex.test(value)) return `Value does not match pattern: ${pattern}`;\n    return true;\n  },\n\n  /**\n   * Required validator\n   * @param {*} value - Value to validate\n   * @returns {boolean|string} True if valid, error message otherwise\n   */\n  required: (value) => {\n    if (value === undefined || value === null || value === '') {\n      return 'Value is required';\n    }\n    return true;\n  }\n};\n\nexport default {\n  createValidatedState,\n  validators,\n  SchemaValidator\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coherent.js/state",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "description": "Reactive state management for Coherent.js applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,14 +25,22 @@
     "type": "git",
     "url": "git+https://github.com/Tomdrouv1/coherent.js.git"
   },
+  "homepage": "https://github.com/Tomdrouv1/coherent.js",
+  "bugs": {
+    "url": "https://github.com/Tomdrouv1/coherent.js/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "peerDependencies": {
-    "@coherent.js/core": "1.0.0-beta.5"
+    "@coherent.js/core": "1.0.0-beta.7"
   },
   "types": "./types/index.d.ts",
   "files": [
+    "dist/",
     "LICENSE",
     "README.md",
     "types/"
@@ -40,6 +48,8 @@
   "sideEffects": false,
   "scripts": {
     "build": "node build.mjs",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
 }

package/types/index.d.ts

@@ -3,138 +3,463 @@
  * @module @coherent.js/state
  */
 
-// ===== Reactive State Types =====
+import type { CoherentNode, ComponentState } from '@coherent.js/core';
 
-export interface Observer<T = any> {
+// ============================================================================
+// Core Store Types
+// ============================================================================
+
+/**
+ * Typed state store with subscribe and update capabilities
+ * @template T - The shape of the state object
+ */
+export interface Store<T extends Record<string, unknown> = Record<string, unknown>> {
+  /**
+   * Get the current state
+   */
+  getState(): T;
+
+  /**
+   * Update state with partial object or updater function
+   */
+  setState(partial: Partial<T> | ((state: T) => Partial<T>)): void;
+
+  /**
+   * Subscribe to state changes
+   * @returns Unsubscribe function
+   */
+  subscribe(listener: (state: T, prevState: T) => void): () => void;
+
+  /**
+   * Destroy the store and clean up subscriptions
+   */
+  destroy(): void;
+}
+
+/**
+ * Store creation options
+ * @template T - The shape of the state object
+ */
+export interface StoreOptions<T extends Record<string, unknown> = Record<string, unknown>> {
+  /** Initial state */
+  initialState: T;
+  /** Persistence configuration */
+  persist?: {
+    /** Storage key */
+    key: string;
+    /** Storage adapter (localStorage, sessionStorage, or custom) */
+    storage?: Storage;
+    /** Custom serialization */
+    serialize?: (state: T) => string;
+    /** Custom deserialization */
+    deserialize?: (value: string) => T;
+    /** Debounce persistence writes (ms) */
+    debounce?: number;
+  };
+  /** Enable devtools integration */
+  devtools?: boolean;
+  /** Store name for debugging */
+  name?: string;
+  /** Middleware functions */
+  middleware?: Array<StoreMiddleware<T>>;
+}
+
+/**
+ * Store middleware function
+ */
+export type StoreMiddleware<T> = (
+  state: T,
+  action: string,
+  payload?: unknown
+) => T | void;
+
+/**
+ * Create a typed state store
+ */
+export function createStore<T extends Record<string, unknown>>(
+  options: StoreOptions<T>
+): Store<T>;
+
+// ============================================================================
+// Selector Types
+// ============================================================================
+
+/**
+ * Create a derived selector from store state
+ * @template T - Store state type
+ * @template R - Return type of selector
+ */
+export function createSelector<T extends Record<string, unknown>, R>(
+  store: Store<T>,
+  selector: (state: T) => R
+): () => R;
+
+/**
+ * Create a memoized selector with dependencies
+ */
+export function createMemoizedSelector<T extends Record<string, unknown>, D extends unknown[], R>(
+  store: Store<T>,
+  dependencies: (...args: D) => unknown[],
+  selector: (state: T, ...deps: D) => R
+): (...args: D) => R;
+
+// ============================================================================
+// Action Types
+// ============================================================================
+
+/**
+ * Action type helper for type-safe actions
+ * @template T - Store state type
+ * @template P - Payload type (void for no payload)
+ */
+export type Action<T, P = void> = P extends void
+  ? () => Partial<T>
+  : (payload: P) => Partial<T>;
+
+/**
+ * Create typed action creators
+ */
+export function createActions<
+  T extends Record<string, unknown>,
+  A extends Record<string, Action<T, unknown>>
+>(
+  store: Store<T>,
+  actions: A
+): {
+  [K in keyof A]: A[K] extends Action<T, infer P>
+    ? P extends void
+      ? () => void
+      : (payload: P) => void
+    : never;
+};
+
+// ============================================================================
+// Reactive State Types
+// ============================================================================
+
+/**
+ * Observer callback type
+ */
+export interface Observer<T = unknown> {
   (value: T, oldValue: T): void;
 }
 
-export class Observable<T = any> {
+/**
+ * Observable value wrapper
+ */
+export class Observable<T = unknown> {
   constructor(initialValue: T);
+
+  /** Get current value */
   get(): T;
+
+  /** Set new value */
   set(value: T): void;
+
+  /** Subscribe to changes */
   subscribe(observer: Observer<T>): () => void;
+
+  /** Unsubscribe observer */
   unsubscribe(observer: Observer<T>): void;
+
+  /** Notify all observers */
   notify(): void;
 }
 
-export interface ReactiveStateOptions<T = any> {
+/**
+ * Reactive state options
+ */
+export interface ReactiveStateOptions<T = unknown> {
+  /** Initial state value */
   initialValue: T;
-  computed?: Record<string, (state: T) => any>;
-  watchers?: Record<string, Observer<any>>;
-  middleware?: Array<(state: T, action: string, payload?: any) => T | void>;
+  /** Computed properties */
+  computed?: Record<string, (state: T) => unknown>;
+  /** Property watchers */
+  watchers?: Record<string, Observer<unknown>>;
+  /** Middleware functions */
+  middleware?: Array<(state: T, action: string, payload?: unknown) => T | void>;
 }
 
-export class ReactiveState<T = any> {
+/**
+ * Reactive state class with computed properties and watchers
+ */
+export class ReactiveState<T extends Record<string, unknown> = Record<string, unknown>> {
   constructor(options: ReactiveStateOptions<T>);
+
+  /** Get a property value */
   get<K extends keyof T>(key: K): T[K];
+
+  /** Set a property value */
   set<K extends keyof T>(key: K, value: T[K]): void;
+
+  /** Update multiple properties */
   update(partial: Partial<T>): void;
+
+  /** Subscribe to all changes */
   subscribe(observer: Observer<T>): () => void;
+
+  /** Watch a specific property */
   watch<K extends keyof T>(key: K, observer: Observer<T[K]>): () => void;
+
+  /** Get full state */
   getState(): T;
+
+  /** Reset to initial state */
   reset(): void;
 }
 
-export function createReactiveState<T = any>(options: ReactiveStateOptions<T>): ReactiveState<T>;
-export function observable<T = any>(initialValue: T): Observable<T>;
-export function computed<T = any>(fn: () => T, dependencies: Observable<any>[]): Observable<T>;
+/**
+ * Create a reactive state instance
+ */
+export function createReactiveState<T extends Record<string, unknown> = Record<string, unknown>>(
+  options: ReactiveStateOptions<T>
+): ReactiveState<T>;
+
+/**
+ * Create a simple observable value
+ */
+export function observable<T = unknown>(initialValue: T): Observable<T>;
+
+/**
+ * Create a computed observable
+ */
+export function computed<T = unknown>(
+  fn: () => T,
+  dependencies: Observable<unknown>[]
+): Observable<T>;
 
+/**
+ * State utility functions
+ */
 export const stateUtils: {
+  /** Batch multiple state updates */
   batch<T>(fn: () => T): T;
+  /** Run updates in a transaction */
   transaction<T>(fn: () => T): T;
+  /** Freeze state (make immutable) */
   freeze<T>(state: T): Readonly<T>;
+  /** Deep clone state */
   clone<T>(state: T): T;
 };
 
-// ===== SSR-Compatible State Manager Types =====
+// ============================================================================
+// SSR-Compatible State Manager
+// ============================================================================
 
-export interface StateManagerOptions<T = any> {
+/**
+ * State manager options
+ */
+export interface StateManagerOptions<T = unknown> {
+  /** Initial state */
   initialState?: T;
+  /** Enable persistence */
   persist?: boolean;
+  /** Persistence key */
   key?: string;
+  /** Middleware functions */
   middleware?: Array<(state: T, action: string) => T | void>;
 }
 
-export interface State<T = any> {
+/**
+ * Simple state interface
+ */
+export interface State<T = unknown> {
+  /** Get current state */
   get(): T;
+  /** Set new state */
   set(value: T): void;
+  /** Update with partial */
   update(partial: Partial<T>): void;
+  /** Subscribe to changes */
   subscribe(listener: (state: T) => void): () => void;
+  /** Reset to initial state */
   reset(): void;
 }
 
-export function createState<T = any>(initialState: T, options?: StateManagerOptions<T>): State<T>;
+/**
+ * Create a simple state container
+ */
+export function createState<T = unknown>(
+  initialState: T,
+  options?: StateManagerOptions<T>
+): State<T>;
 
+/**
+ * Global state manager for SSR
+ */
 export const globalStateManager: {
-  getState<T = any>(key: string): T | undefined;
-  setState<T = any>(key: string, value: T): void;
-  subscribe<T = any>(key: string, listener: (state: T) => void): () => void;
+  /** Get state by key */
+  getState<T = unknown>(key: string): T | undefined;
+  /** Set state by key */
+  setState<T = unknown>(key: string, value: T): void;
+  /** Subscribe to state key */
+  subscribe<T = unknown>(key: string, listener: (state: T) => void): () => void;
+  /** Clear state (optionally by key) */
   clear(key?: string): void;
 };
 
-// ===== Context API Types =====
+// ============================================================================
+// Context API
+// ============================================================================
 
-export interface ContextValue<T = any> {
+/**
+ * Context value wrapper
+ */
+export interface ContextValue<T = unknown> {
   value: T;
   subscribers: Set<(value: T) => void>;
 }
 
-export function provideContext<T = any>(key: string, value: T): void;
-export function createContextProvider<T = any>(key: string, value: T): { key: string; value: T };
-export function useContext<T = any>(key: string, defaultValue?: T): T;
-export function restoreContext(contexts: Record<string, any>): void;
+/**
+ * Provide a context value
+ */
+export function provideContext<T = unknown>(key: string, value: T): void;
+
+/**
+ * Create a context provider
+ */
+export function createContextProvider<T = unknown>(
+  key: string,
+  value: T
+): { key: string; value: T };
+
+/**
+ * Use/consume a context value
+ */
+export function useContext<T = unknown>(key: string, defaultValue?: T): T;
+
+/**
+ * Restore context from saved state
+ */
+export function restoreContext(contexts: Record<string, unknown>): void;
+
+/**
+ * Clear all context stacks
+ */
 export function clearAllContexts(): void;
 
-// ===== Persistent State Types =====
+// ============================================================================
+// Persistent State
+// ============================================================================
 
+/**
+ * Persistence adapter interface
+ */
 export interface PersistenceAdapter {
+  /** Get item from storage */
   getItem(key: string): Promise<string | null> | string | null;
+  /** Set item in storage */
   setItem(key: string, value: string): Promise<void> | void;
+  /** Remove item from storage */
   removeItem(key: string): Promise<void> | void;
 }
 
-export interface PersistentStateOptions<T = any> extends StateManagerOptions<T> {
+/**
+ * Persistent state options
+ */
+export interface PersistentStateOptions<T = unknown> extends StateManagerOptions<T> {
+  /** Required: storage key */
   key: string;
+  /** Storage adapter */
   storage?: PersistenceAdapter;
+  /** Custom serialization */
   serialize?: (state: T) => string;
+  /** Custom deserialization */
   deserialize?: (data: string) => T;
+  /** Debounce writes (ms) */
   debounce?: number;
 }
 
-export function createPersistentState<T = any>(options: PersistentStateOptions<T>): State<T>;
-export function withLocalStorage<T = any>(state: State<T>, key: string): State<T>;
-export function withSessionStorage<T = any>(state: State<T>, key: string): State<T>;
-export function withIndexedDB<T = any>(state: State<T>, key: string, dbName?: string): Promise<State<T>>;
+/**
+ * Create a persistent state
+ */
+export function createPersistentState<T = unknown>(
+  options: PersistentStateOptions<T>
+): State<T>;
+
+/**
+ * Wrap state with localStorage persistence
+ */
+export function withLocalStorage<T = unknown>(state: State<T>, key: string): State<T>;
+
+/**
+ * Wrap state with sessionStorage persistence
+ */
+export function withSessionStorage<T = unknown>(state: State<T>, key: string): State<T>;
+
+/**
+ * Wrap state with IndexedDB persistence
+ */
+export function withIndexedDB<T = unknown>(
+  state: State<T>,
+  key: string,
+  dbName?: string
+): Promise<State<T>>;
 
-// ===== Validated State Types =====
+// ============================================================================
+// Validated State
+// ============================================================================
 
-export interface ValidationRule<T = any> {
+/**
+ * Validation rule function
+ */
+export interface ValidationRule<T = unknown> {
   (value: T): boolean | string;
 }
 
-export interface ValidatedStateOptions<T = any> extends StateManagerOptions<T> {
-  validators: Record<keyof T, ValidationRule<T[keyof T]>[]>;
+/**
+ * Validated state options
+ */
+export interface ValidatedStateOptions<T extends Record<string, unknown> = Record<string, unknown>>
+  extends StateManagerOptions<T> {
+  /** Validation rules by property */
+  validators: { [K in keyof T]?: ValidationRule<T[K]>[] };
+  /** Validate on every change */
   validateOnChange?: boolean;
+  /** Throw on validation failure */
   strict?: boolean;
 }
 
-export interface ValidatedState<T = any> extends State<T> {
-  validate(): { valid: boolean; errors: Record<keyof T, string[]> };
+/**
+ * Validated state interface
+ */
+export interface ValidatedState<T extends Record<string, unknown> = Record<string, unknown>>
+  extends State<T> {
+  /** Validate current state */
+  validate(): { valid: boolean; errors: { [K in keyof T]?: string[] } };
+  /** Check if state is valid */
   isValid(): boolean;
-  getErrors(): Record<keyof T, string[]>;
+  /** Get validation errors */
+  getErrors(): { [K in keyof T]?: string[] };
 }
 
-export function createValidatedState<T = any>(options: ValidatedStateOptions<T>): ValidatedState<T>;
+/**
+ * Create a validated state
+ */
+export function createValidatedState<T extends Record<string, unknown> = Record<string, unknown>>(
+  options: ValidatedStateOptions<T>
+): ValidatedState<T>;
 
+/**
+ * Built-in validators
+ */
 export const validators: {
+  /** Required value */
   required(message?: string): ValidationRule;
+  /** Minimum length */
   minLength(length: number, message?: string): ValidationRule;
+  /** Maximum length */
   maxLength(length: number, message?: string): ValidationRule;
+  /** Minimum value */
   min(value: number, message?: string): ValidationRule;
+  /** Maximum value */
   max(value: number, message?: string): ValidationRule;
+  /** Pattern matching */
   pattern(regex: RegExp, message?: string): ValidationRule;
+  /** Email format */
   email(message?: string): ValidationRule;
+  /** URL format */
   url(message?: string): ValidationRule;
-  custom(fn: (value: any) => boolean | string): ValidationRule;
+  /** Custom validator */
+  custom(fn: (value: unknown) => boolean | string): ValidationRule;
 };