ueca-react 1.0.7 → 2.0.0

package/docs/index.md

@@ -1,24 +1,44 @@
 ![logo](/docs/logo.png)
 
-## UECA Programming Documentation
+## UECA-React 2.0 Programming Documentation
 
-### [1. Component Mental Model](/docs/component-mental-model.md)
+### [1. Introduction](/docs/Introduction%20to%20UECA-React.md)
 
-### [2. Component Integration Model](/docs/component-intergation-model.md)
+### [2. Technology](/docs/Technology%20of%20UECA-React.md)
 
-### [3. Introduction to UECA](/docs/introduction.md)
+### [3. Component Mental Model](/docs/Component%20Mental%20Model%20in%20UECA-React.md)
 
-### [4. Technology of UECA ](/docs/technology.md)
+### [4. Component Integration Model](/docs/Component%20Integration%20Model%20in%20UECA-React.md)
 
-### [5. Base Concepts of UECA ](/docs/base-concepts.md)
+### [5. Introduction to Components](/docs/Introduction%20to%20UECA-React%20Components.md)
 
-### [6. General Code Structure](/docs/general-code-structure.md)
+### [6. Component IDs](/docs/Component%20IDs%20in%20UECA-React.md)
 
-### [7. Property Bindings ](/docs/bindings-overview.md)
+### [7. Lifecycle Hooks](/docs/Lifecycle%20Hooks%20in%20UECA-React.md)
 
-### [8. Message Bus ](/docs/message-bus.md)
+### [8. State Management](/docs/State%20Management%20in%20UECA-React.md)
 
-### [9. Standard Code Template](/docs/code-template.md)
+### [9. Property Bindings](/docs/Property%20Bindings%20in%20UECA-React.md)
+
+### [10. Automatic onChange\<Prop> Events](/docs/Automatic%20onChange%20Events%20in%20UECA-React.md)
+
+### [11. Automatic onChanging\<Prop> Events](/docs/Automatic%20onChanging%20Events%20in%20UECA-React.md)
+
+### [12. Automatic onPropChange and onPropChanging Events](/docs/Automatic%20onPropChange%20and%20onPropChanging%20Events%20in%20UECA-React.md)
+
+### [13. Message Bus](/docs/Message%20Bus%20in%20UECA-React.md)
+
+### [14. Arrays and Reactivity in UECA-React](/docs/Arrays%20and%20Reactivity%20in%20UECA-React.md)
+
+### [15. Model Caching](/docs/Model%20Caching%20in%20UECA-React.md)
+
+### [16. Component Extension in UECA-React](/docs/Component%20Extension%20in%20UECA-React.md)
+
+### [17. Tracing](/docs/Logging%20and%20Tracing%20in%20UECA-React.md)
+
+### [18. Standard Code Template](/docs/code-template.md)
+
+#
 
 ## Code Examples on CodeSandbox
-#### [UECA Basics: Application (Code Examples Menu)](https://codesandbox.io/p/sandbox/frosty-banach-jsf84c)
+#### [UECA-React Basics: Application (Code Examples Main Menu)](https://codesandbox.io/p/sandbox/frosty-banach-jsf84c)

package/package.json

@@ -1,76 +1,72 @@
 {
-  "name": "ueca-react",
-  "version": "1.0.7",
-  "description": "Unified Encapsulated Component Architecture for React",
-  "keywords": [
-    "ueca",
-    "react",
-    "typescript",
-    "framework",
-    "abstraction",
-    "unified",
-    "encapsulated",
-    "component",
-    "architecture",
-    "message bus",
-    "bindings"
-  ],
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/nekutuzov/ueca-react-npm.git"
-  },
-  "files": [
-    "dist",
-    "docs",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "jest"
-  },
-  "author": "Aleksey Suvorov",
-  "license": "ISC",
-  "dependencies": {            
-    "mobx-react": "^9.1.1"
-  },
-  "peerDependencies": {    
-    "lodash": "^4.17.21"    
-  },
-  "devDependencies": {    
-    "@babel/core": "^7.26.10",
-    "@babel/preset-env": "^7.26.9",
-    "@babel/preset-react": "^7.26.3",
-    "@babel/preset-typescript": "^7.27.0",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "^16.3.0",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/react": "^18.3.2",
-    "@types/jest": "^29.5.14",
-    "@types/lodash": "^4.17.4",
-    "@types/node": "^20.12.12",    
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "typescript": "^5.8.3"
-  },
-  "jest": {
-    "testEnvironment": "jsdom",
-    "testMatch": [
-      "**/?(*.)+(test).[jt]s?(x)"
+    "name": "ueca-react",
+    "version": "2.0.0",
+    "description": "Unified Encapsulated Component Architecture for React",
+    "author": "Aleksey Suvorov <cranesoft@protonmail.com>",
+    "license": "ISC",
+    "keywords": [
+        "ueca",
+        "react",
+        "typescript",
+        "framework",
+        "abstraction",
+        "unified",
+        "encapsulated",
+        "component",
+        "architecture",
+        "message bus",
+        "bindings",
+        "AI code generation"
     ],
-    "moduleFileExtensions": [
-      "ts",
-      "tsx",
-      "js",
-      "jsx"
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/nekutuzov/ueca-react.git"
+    },
+    "homepage": "https://github.com/nekutuzov/ueca-react#readme",
+    "bugs": {
+        "url": "https://github.com/nekutuzov/ueca-react/issues"
+    },
+    "main": "dist/ueca-react.js",
+    "module": "dist/ueca-react.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "docs",
+        "README.md",
+        "LICENSE"
     ],
-    "setupFilesAfterEnv": [
-      "@testing-library/jest-dom"
-    ],
-    "moduleNameMapper": {
-      "ueca": "<rootDir>/src/index.ts"
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "tsc -b && vite build",
+        "lint": "eslint .",
+        "preview": "vite preview",
+        "test": "vitest run"
+    },
+    "peerDependencies": {
+        "mobx": "^6.9.0",
+        "mobx-react": "^9.1.1",
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0"
+    },
+    "devDependencies": {
+        "@eslint/js": "^9.29.0",
+        "@testing-library/jest-dom": "^6.6.3",
+        "@testing-library/react": "^16.3.0",
+        "@testing-library/user-event": "^14.6.1",
+        "@types/node": "^22.15.18",
+        "@types/react": "^19.0.0",
+        "@types/react-dom": "^19.0.0",
+        "@vitejs/plugin-react": "^4.5.2",
+        "eslint": "^9.29.0",
+        "eslint-plugin-react-hooks": "^5.2.0",
+        "eslint-plugin-react-refresh": "^0.4.20",
+        "globals": "^16.2.0",
+        "jsdom": "^26.1.0",
+        "typescript": "~5.8.3",
+        "typescript-eslint": "^8.34.1",
+        "vite": "^7.0.0",
+        "vite-plugin-dts": "^4.5.4",
+        "vitest": "^3.1.1"
     }
-  }
-}
+}

package/dist/componentModel.d.ts

@@ -1,127 +0,0 @@
-import * as React from 'react';
-import { IReactionDisposer } from "mobx";
-import { AnyMessage, AnyName, IMessageBus, Messages } from "./messageBus";
-type ComponentTemplate = {
-    props?: {};
-    children?: {};
-    methods?: {};
-    events?: {};
-};
-type ComponentProps<TStruct extends ComponentTemplate> = TStruct["props"];
-type ComponentChildren<TStruct extends ComponentTemplate> = TStruct["children"];
-type ComponentMethods<TStruct extends ComponentTemplate> = TStruct["methods"];
-type ComponentEvents<TStruct extends ComponentTemplate> = TStruct["events"];
-type ComponentMessages<TStruct extends ComponentStructBase<TMsg>, TMsg extends AnyMessage> = TStruct["messages"];
-type ComponentStructEvents<TProps> = {
-    onPropChanging?: (prop: keyof TProps, newValue: any, oldValue: any) => any;
-    onPropChange?: (prop: keyof TProps, value: any) => void;
-} & {
-    [Evt in keyof TProps as `onGet${Capitalize<Evt & string>}`]?: () => TProps[Evt];
-} & {
-    [Evt in keyof TProps as `onChanging${Capitalize<Evt & string>}`]?: (newValue: TProps[Evt], oldValue: TProps[Evt]) => TProps[Evt];
-} & {
-    [Evt in keyof TProps as `onChange${Capitalize<Evt & string>}`]?: (value: TProps[Evt]) => void;
-};
-type ComponentViewProps = {
-    render?: boolean;
-    children?: React.ReactNode;
-};
-type ComponentView = (params?: ComponentViewProps) => JSX.Element;
-type Bond<T> = [() => T, (value: T) => void];
-type StructProp<T> = T | (() => T) | Bond<T>;
-type StructProps<TProps> = {
-    [Prop in keyof TProps]: StructProp<TProps[Prop]>;
-};
-type ComponentStructBase<TMsg extends AnyMessage> = ComponentTemplate & {
-    props?: {
-        id?: string;
-    };
-    messages?: Messages<TMsg>;
-    View?: ComponentView;
-    BaseView?: ComponentView;
-    init?: (model: ComponentModel<ComponentStructBase<TMsg>, TMsg>) => void;
-    mount?: (model: ComponentModel<ComponentStructBase<TMsg>, TMsg>) => void;
-    unmount?: (model: ComponentModel<ComponentStructBase<TMsg>, TMsg>) => void;
-    __struct?: ComponentStructBase<TMsg>;
-};
-type PartialComponentTemplate<TStruct extends ComponentTemplate, TMsg extends AnyMessage> = {
-    props?: Partial<StructProps<ComponentProps<TStruct>>>;
-    children?: Partial<ComponentChildren<TStruct>>;
-    methods?: Partial<ComponentMethods<TStruct>>;
-    events?: Partial<ComponentStructEvents<ComponentProps<TStruct>>> & Partial<ComponentEvents<TStruct>>;
-    messages?: Partial<ComponentMessages<TStruct, TMsg>>;
-};
-type ComponentStruct<TStruct extends ComponentTemplate, TMsg extends AnyMessage = AnyMessage> = PartialComponentTemplate<ComponentStructBase<TMsg>, TMsg> & Omit<TStruct & ComponentStructBase<TMsg>, "props" | "children" | "methods" | "events" | "messages"> & PartialComponentTemplate<TStruct, TMsg> & {
-    __struct?: TStruct;
-};
-type AnyComponentParams = ComponentParams<AnyComponentStruct, AnyMessage>;
-type AnyComponentStruct = ComponentStruct<ComponentStructBase<AnyMessage>, AnyMessage>;
-type AnyComponentModel = ComponentModel<AnyComponentStruct, AnyMessage>;
-type DynamicChildren = Record<string, AnyComponentModel>;
-type ComponentParams<TStruct extends ComponentStruct<ComponentStructBase<TMsg>, TMsg>, TMsg extends AnyMessage = {}> = Partial<ComponentProps<TStruct>> & Partial<ComponentEvents<TStruct>> & {
-    init?: (model: ComponentModel<TStruct, TMsg>) => void;
-    mount?: (model: ComponentModel<TStruct, TMsg>) => void;
-    unmount?: (model: ComponentModel<TStruct, TMsg>) => void;
-} & {
-    owner?: DynamicChildren;
-};
-type ComponentPrivateMembers = {
-    __owner: AnyComponentModel;
-    __deleteMember: (name: string) => boolean;
-    __calledFromJSX: boolean;
-    __messages: Partial<Messages<AnyMessage>>;
-    __propBindings: string[];
-    __mounted: boolean;
-    __initialize: () => void;
-    __unmount: () => void;
-    __updateInitializedModelProperties: (params: AnyComponentParams) => void;
-    __autoRunDisposers: IReactionDisposer[];
-    bus: IMessageBus<AnyMessage, AnyName>;
-    View: ComponentView;
-    BaseView: ComponentView;
-    firstTimeRendering: boolean;
-    disableOnChange: () => void;
-    enableOnChange: () => void;
-    changeNotifyDisabled: () => boolean;
-    fullId: () => string;
-    htmlId: () => string;
-    birthMark: () => string;
-    calledFromJSX: () => boolean;
-    init: (model: ComponentModel<AnyComponentStruct, AnyMessage>) => void;
-    mount: (model: ComponentModel<AnyComponentStruct, AnyMessage>) => void;
-    unmount: (model: ComponentModel<AnyComponentStruct, AnyMessage>) => void;
-};
-declare const $: unique symbol;
-type ComponentModel<TStruct extends ComponentStruct<ComponentStructBase<TMsg>, TMsg>, TMsg extends AnyMessage = {}> = ComponentProps<TStruct["__struct"]> & Readonly<ComponentChildren<TStruct["__struct"]>> & Readonly<ComponentMethods<TStruct["__struct"]>> & ComponentStructEvents<ComponentProps<TStruct["__struct"]>> & ComponentEvents<TStruct["__struct"]> & {
-    readonly [$]: ComponentPrivateMembers;
-    readonly bus: IMessageBus<TMsg, AnyName>;
-    readonly View: ComponentView;
-    readonly BaseView: ComponentView;
-    readonly disableOnChange: () => void;
-    readonly enableOnChange: () => void;
-    readonly changeNotifyDisabled: () => boolean;
-    readonly fullId: () => string;
-    readonly htmlId: () => string;
-    readonly birthMark: () => string;
-    readonly calledFromJSX: () => boolean;
-};
-type ComponentModelTrapRegistry = {
-    readonly _hookCallsCount: number;
-    readonly _newModels: AnyComponentModel[];
-    readonly models: AnyComponentModel[];
-    readonly cached: boolean;
-    readonly nextCachedModel: () => AnyComponentModel;
-    readonly cacheModel: (model: AnyComponentModel) => void;
-    readonly updateCache: (owner: AnyComponentModel) => void;
-};
-declare const blankView: () => any;
-declare function useComponent<TStruct extends ComponentStruct<ComponentStructBase<TMsg>, TMsg>, TMsg extends AnyMessage>(struct: TStruct, params?: ComponentParams<TStruct>): ComponentModel<TStruct, TMsg>;
-declare function mergeStruct<TStruct extends ComponentStruct<ComponentStructBase<TMsg>, TMsg>, TExt extends ComponentStruct<ComponentStructBase<TMsg>, TMsg>, TMsg extends AnyMessage>(struct: TStruct, extStruct: TExt, model: () => ComponentModel<TExt, TMsg>): TStruct & TExt;
-declare function bind<T>(get: () => T, set: (value: T) => void): Bond<T>;
-declare function bindProp<T, P extends keyof T>(obj: () => T, prop: P): Bond<T[P]>;
-declare function newComponentModelTrapRegistry(cache?: AnyComponentModel[]): ComponentModelTrapRegistry;
-declare const ComponentModelTrap: React.Context<ComponentModelTrapRegistry>;
-declare function useComponentModelTrap(): ComponentModelTrapRegistry;
-declare function getFC<TStruct extends ComponentStruct<ComponentStructBase<TMsg>, TMsg>, TMsg extends AnyMessage>(modelHook: (params: ComponentParams<TStruct>) => ComponentModel<TStruct, TMsg>): (params: ComponentParams<TStruct>) => JSX.Element;
-declare function componentModelDebug(text: string): void;
-export { ComponentModel, AnyComponentModel, ComponentTemplate, ComponentStruct, ComponentProps, ComponentMethods, ComponentEvents, ComponentMessages, ComponentParams, ComponentView, DynamicChildren, ComponentModelTrap, ComponentModelTrapRegistry, useComponentModelTrap, newComponentModelTrapRegistry, useComponent, mergeStruct, blankView, bind, bindProp, componentModelDebug, getFC, $ };