plug-code 1.1.15 → 1.1.17

package/LICENSE

@@ -1,21 +1,18 @@
-MIT License
+Plug&Code License
 
-Copyright (c) 2025 Alan Mendez
+Copyright (c) 2026 AlaunS
 
-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:
+All rights reserved.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+Permission is hereby granted to use this software for personal and commercial projects.
+You may modify the software for your own internal use.
 
-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.
+You may NOT:
+- Redistribute this software or any modified version of it.
+- Sell, sublicense, publish, or share this software.
+- Use this software as the basis for another framework, library, or competing product.
+
+This 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 author be liable
+for any claim, damages or other liability arising from the use of this software.

package/README.md

@@ -4,8 +4,8 @@
 It empowers developers to build complex applications by **plugging in independent feature modules** without tightly coupling the codebase.
 
 > **License**
-> You may use Plug&Code in personal or commercial projects.
-> **Modification or redistribution of the framework source code is prohibited** without explicit permission.
+> This project is licensed under the Plug&Code License.
+> See the LICENSE file for details.
 
 ---
 
@@ -67,8 +67,7 @@ import { PaginationFeature } from './features/PaginationFeature';
 import { SalesFeature } from './features/SalesFeature';
 
 export const { useSystemPlc, SystemPlcRoot } = createPlugAndCode((api) => {
-  api.createData("root", { appName: "My Dashboard", theme: "dark" });
-
+  // It creates root automatically | root = {}
   PaginationFeature(api);
   SalesFeature(api);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plug-code",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "",
   "main": "src/plug-code.tsx",
   "types": "types/plug-code.d.ts",

package/src/core/plcAPI.tsx

@@ -1,6 +1,6 @@
 import { produce } from "immer";
 import type { ObjectType } from "../types/general";
-import { useEffect, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import { PlcPipeline } from "./plcPipeline";
 import type { PlcStore } from "./plcStore";
 import type { CommandFn, transformerType } from "../types/api";
@@ -28,7 +28,6 @@ export class PlcAPI<S extends ObjectType> {
 
     private transformers = new Map<string, transformerType[]>()
     private commands = new Map<string, CommandFn>();
-    private installedFeatures = new Set<string>();
 
     constructor(store: PlcStore<S>) {
         this.store = store
@@ -122,57 +121,67 @@ export class PlcAPI<S extends ObjectType> {
         return () => lastValue
     }
 
-    register(slot: SlotKey, node: () => React.ReactNode): void;
-    register<K extends string>(slot: SlotKey, node: (data: any) => React.ReactNode, dependencyKey: K): void;
-    register(slot: SlotKey, node: (data?: any) => React.ReactNode, dependencyKey?: string) {
+    register(slot: SlotKey, node: (props?: any) => React.ReactNode): void;
+    register<K extends string>(slot: SlotKey, node: (data: any, props?: any) => React.ReactNode, dependencyKey: K): void;
+    register(slot: SlotKey, node: (data?: any, props?: any) => React.ReactNode, dependencyKey?: string) {
         if (dependencyKey) {
-            const ConnectedWrapper = () => {
-                const [data, setData] = useState(() => this.substores.get(dependencyKey));
+            const ConnectedWrapper = (props: any) => {
+                const [storeData, setStoreData] = useState(() => this.substores.get(dependencyKey));
 
                 useEffect(() => {
                     const unsubscribe = this.store.subscribe(dependencyKey as any, () => {
-                        setData(this.substores.get(dependencyKey));
+                        setStoreData(this.substores.get(dependencyKey));
                     });
                     return unsubscribe;
                 }, []);
 
-                return node(data);
+                return <>{node(storeData, props)}</>;
             };
 
             this.store.batch(() => {
-                this.pipeline.register(slot as string, () => <ConnectedWrapper />);
+                this.pipeline.register(slot as string, ConnectedWrapper);
             });
         }
         else {
             this.store.batch(() => {
-                this.pipeline.register(slot as string, node as () => React.ReactNode);
+                this.pipeline.register(slot as string, node);
             });
         }
     }
 
     scope<T = any>(key: string | "root"): {
         get: () => T;
-        update: (updater: (draft: T) => void) => void;
-        connect: (renderer: (data: T) => React.ReactNode) => React.FC;
-        render: (slotName: SlotKey) => React.ReactNode | null;
+        update: (updater: (draft: T) => void, slot?: string, triggerKey?: string) => void;
+        connect: <P = {}, R = any>(
+            selector: (data: T, props: P) => R
+        ) => (WrappedComponent: React.ComponentType<P & R>) => React.FC<P>;
+
+        render: (slotName: SlotKey) => React.FC;
         receive: (context?: any) => any;
         root: PlcAPI<S>;
     } {
         return {
             get: (): T => this.getData(key),
 
-            update: (updater: (draft: T) => void) => {
-                this.update(key as any, updater);
+            update: (updater: (draft: T) => void, slot?: string, triggerKey?: string) => {
+                this.update(key as any, updater, slot, triggerKey);
             },
 
-            connect: (renderer: (data: T) => React.ReactNode) => {
-                return this.connect(key, renderer);
+            connect: <P = {}, R = any>(
+                selector: (data: T, props: P) => R
+            ) => {
+                return this.connect(key, selector);
             },
 
             render: (slotName: SlotKey) => {
-                return this.connect(key, (localData) => {
-                    return this.pipeline.render(slotName as string, localData) as React.ReactNode;
-                }) as any;
+                const ScopedSlotRenderer = ({ _scopeData }: { _scopeData: T }) => {
+                    return <>{this.pipeline.render(slotName as string, _scopeData)}</>;
+                };
+
+                return this.connect(
+                    key,
+                    (data: T) => ({ _scopeData: data })
+                )(ScopedSlotRenderer) as any;
             },
 
             receive: (context: any = {}) => {
@@ -184,25 +193,53 @@ export class PlcAPI<S extends ObjectType> {
         };
     }
 
-    connect<T = any>(key: string, renderer: (data: T) => React.ReactNode): React.FC {
-        return () => {
-            const [data, setData] = useState<T>(() => this.substores.get(key));
+    connect<State = any, OwnProps = {}, ResultProps = {}>(
+        key: string,
+        selector: (state: State, props: OwnProps) => ResultProps
+    ): (WrappedComponent: React.ComponentType<OwnProps & ResultProps>) => React.FC<OwnProps> {
+        return (WrappedComponent: React.ComponentType<OwnProps & ResultProps>) => {
+
+            const ConnectedComponent = (props: OwnProps) => {
+                const propsRef = useRef(props);
+                propsRef.current = props;
 
-            useEffect(() => {
-                const unsubscribe = this.store.subscribe(key as any, () => {
-                    setData(this.substores.get(key));
+                const [slice, setSlice] = useState<ResultProps>(() => {
+                    const data = this.substores.get(key);
+                    return selector(data, props);
                 });
 
-                return () => {
-                    unsubscribe();
-                };
-            }, []);
+                useEffect(() => {
+                    const unsubscribe = this.store.subscribe(key as any, () => {
+                        const currentData = this.substores.get(key);
+                        const newSlice = selector(currentData, propsRef.current);
+
+                        setSlice(prev => {
+                            if (prev === newSlice) return prev;
+
+                            if (typeof prev === 'object' && prev !== null && typeof newSlice === 'object' && newSlice !== null) {
+                                const keysA = Object.keys(prev) as Array<keyof ResultProps>;
+                                const keysB = Object.keys(newSlice) as Array<keyof ResultProps>;
+                                if (keysA.length === keysB.length && keysA.every(k => prev[k] === newSlice[k])) {
+                                    return prev;
+                                }
+                            }
+
+                            return newSlice;
+                        });
+                    });
+                    return unsubscribe;
+                }, []);
+
+                if (slice === undefined && this.substores.get(key) === undefined) return null;
+                return <WrappedComponent {...props} {...slice} />;
+            };
+
+            const displayName = WrappedComponent.displayName || WrappedComponent.name || 'Component';
+            ConnectedComponent.displayName = `Connect(${displayName})`;
 
-            if (data === undefined) return null;
-            return <>{renderer(data)}</>;
+            return ConnectedComponent;
         };
     }
-
     wrap(slot: SlotKey, fn: (next: () => React.ReactNode) => () => React.ReactNode) {
         this.store.batch(() => {
             this.pipeline.wrap(slot as string, fn)
@@ -215,8 +252,8 @@ export class PlcAPI<S extends ObjectType> {
         })
     }
 
-    render(slot: SlotKey) {
-        return this.pipeline.render(slot as string)
+    render(slot: SlotKey, props?: any) {
+        return this.pipeline.render(slot as string, props)
     }
 
     invalidate(slot?: SlotKey) {

package/src/core/plcPipeline.tsx

@@ -1,4 +1,4 @@
-import React from "react";
+import React, { useContext } from "react";
 import { ScopeContext } from "../contexts/pipeline";
 import type { ObjectType } from "../types/general";
 import type { ScheduledSlot, Slot } from "../types/pipeline";
@@ -73,9 +73,15 @@ export class PlcPipeline<S extends ObjectType> {
     }
 
     private regenerateCache(slot: string) {
-        const nodes = this.slots.get(slot)?.map((fn, i) => (
-            <React.Fragment key={i}>{fn()}</React.Fragment>
-        )) || [];
+        const nodes = this.slots.get(slot)?.map((fn, i) => {
+            const SlotBridge = () => {
+                const dynamicProps = useContext(ScopeContext);
+                return <React.Fragment>{fn(dynamicProps)}</React.Fragment>;
+            };
+
+            return <SlotBridge key={i} />;
+        }) || [];
+
         this.cache.set(slot, nodes);
     }
 }

package/src/types/pipeline.ts

@@ -1,3 +1,3 @@
 
-export type Slot = () => React.ReactNode
+export type Slot = (props?: any) => React.ReactNode
 export type ScheduledSlot = { slot: string, fn: Slot, priority: number }

package/types/plug-code.d.ts

@@ -7,6 +7,8 @@ import * as React from 'react';
 export declare type ObjectType = Record<string, any>;
 
 export type Slot = () => React.ReactNode;
+interface SlotRegistry {}
+type SlotKey = keyof SlotRegistry | (string & {});
 
 /**
  * Función para ejecutar lógica de negocio (Acciones).
@@ -56,8 +58,8 @@ export declare class PlcAPI<S extends ObjectType> {
     override<K extends string>(key: K & "root", data: any, slot?: string): void
     // --- Gestión de UI (Slots & Rendering) ---
 
-    register(slot: string, node: () => React.ReactNode): void;
-    register<K extends string>(slot: string, node: (data: any) => React.ReactNode, dependencyKey: K): void;
+    register(slot: string, node: (props?: any) => React.ReactNode): void;
+    register<K extends string>(slot: string, node: (data: any, props?: any) => React.ReactNode, dependencyKey: K): void;
 
     /** Envuelve un slot existente (Decorador/Wrapper) */
     wrap(slot: string, fn: (next: () => React.ReactNode) => () => React.ReactNode): void;
@@ -88,15 +90,18 @@ export declare class PlcAPI<S extends ObjectType> {
      */
     scope<T = any>(key: string): {
         get: () => T;
-        update: (updater: (draft: T) => void) => void;
-        connect: (renderer: (data: T) => React.ReactNode) => React.FC;
-        render: (slotName: string) => React.ReactNode | null;
+        update: (updater: (draft: T) => void, slot?: string, triggerKey?: string) => void;
+        connect: <P = {}, R = any>(
+            selector: (data: T, props: P) => R
+        ) => (WrappedComponent: React.ComponentType<P & R>) => React.FC<P>;
+
+        render: (slotName: SlotKey) => React.FC;
         receive: (context?: any) => any;
         root: PlcAPI<S>;
     };
 
     /** Conecta un componente a una parte del estado (HOC) */
-    connect<T = any>(key: string, renderer: (data: T) => React.ReactNode): React.FC;
+    connect<State = any, OwnProps = {}, ResultProps = {}>(key: string, selector: (state: State, props: OwnProps) => ResultProps): (WrappedComponent: React.ComponentType<OwnProps & ResultProps>) => React.FC<OwnProps>;
 
     // --- Pipeline de Datos (Transforms) ---