Renderizado quirúrgico
Actualiza únicamente los nodos de texto y atributos que han cambiado al llamar a apply(), manteniendo el resto del DOM intacto.
Framework JavaScript ligero para crear componentes encapsulados con renderizado quirúrgico, data binding bidireccional, modales arrastrables y router SPA con rutas anidadas.
npm install @pablotheblink/scopejs
Funciona como script clásico UMD, ES Modules o paquete npm sin transpilador ni bundler.
Con gestor de paquetes (npm)
$ npm install @pablotheblink/scopejs
// ES Modules / TypeScript
import { Component, Modal, Router }
from "@pablotheblink/scopejs";
// CommonJS
const { Component } = require(
"@pablotheblink/scopejs");
Directo por CDN (unpkg)
<!-- Sin compilación: unpkg CDN -->
<script
src="https://unpkg.com/@pablotheblink/scopejs@2.0.8/js/ScopeJS.js"
></script>
<script>
const App = ScopeJS.Component({
controller: class { constructor() { this.msg = "Hola"; } },
render() { return `<h1>${this.msg}</h1>`; }
});
App.render(document.getElementById("app"));
</script>
Define tu controlador en JavaScript estándar y llama a this.apply() para parchear únicamente lo que cambió.
import { Component } from "@pablotheblink/scopejs";
const Counter = Component({
controller: class {
constructor() { this.count = 0; this.step = 1; }
increment() { this.count += this.step; this.apply(); }
},
render() {
return `<h3>Contador: ${this.count}</h3>
<button onclick="increment()">+${this.step}</button>`;
},
style: "padding: 1rem; border-radius: 12px;"
});
Counter.render(document.getElementById("app"));
Prueba la instancia real de ScopeJS v2.0.8 o abre el configurador interactivo (/demo) →.
// Lista de tareas reactiva con model
const Todo = ScopeJS.Component({
controller: class {
constructor() { this.draft = ""; this.items = []; }
add() {
this.items.push({ id: Date.now(), text: this.draft });
this.draft = ""; this.apply();
}
},
render() {
return `<input model="draft" /><button onclick="add()">Añadir</button>`;
}
});
Componentes, formularios reactivos, ventanas flotantes y enrutamiento jerárquico sin arrastrar dependencias.
Actualiza únicamente los nodos de texto y atributos que han cambiado al llamar a apply(), manteniendo el resto del DOM intacto.
Controlador en clase ES6, plantilla HTML, CSS scoped automático y ciclo de vida postRender en un único objeto declarativo.
El atributo model sincroniza inputs y propiedades anidadas (user.name) sin configuración adicional ni observadores pesados.
Sistema de ventanas emergentes con overlay, modo ventana sin bloqueo (windowMode), arrastre (draggable) y apilamiento z-index automático.
Navegación SPA con parámetros dinámicos (:id), middleware, herencia de prefijos y <router-outlet> para layouts compartidos.
Compatible con ES Modules, CommonJS y script clásico UMD con declaraciones TypeScript oficiales en types/index.d.ts.
Patrones reales extraídos de la documentación de ScopeJS: contador, tareas, ventana arrastrable y rutas anidadas.
Componente mínimo con estado en el controlador, paso configurable, CSS scoped y actualización quirúrgica mediante this.apply().
const Counter = ScopeJS.Component({
controller: class {
constructor() { this.count = 0; this.step = 1; }
increment() { this.count += this.step; this.apply(); }
reset() { this.count = 0; this.apply(); }
},
render() {
return `<h3>Contador: ${this.count}</h3>
<button onclick="increment()">+${this.step}</button>
<button onclick="reset()">Reset</button>`;
}
});
Counter.render(document.getElementById("app"));
Sincronización automática de input con model="newTodo", filtros por estado y renderizado de colecciones en vanilla JS.
const TodoList = ScopeJS.Component({
controller: class {
constructor() { this.todos = []; this.newTodo = ""; }
addTodo() {
if (!this.newTodo.trim()) return;
this.todos.push({ id: Date.now(), text: this.newTodo, done: false });
this.newTodo = "";
this.apply();
}
},
render() {
return `<input type="text" model="newTodo" placeholder="Nueva tarea...">
<button onclick="addTodo()">Añadir</button>`;
}
});
Abre múltiples ventanas simultáneas sin bloquear la página, con barra de título, arrastre dentro del viewport y bring-to-front automático.
ScopeJS.Modal({
title: "Panel de propiedades",
draggable: true,
windowMode: true,
position: { x: 120, y: 90 },
controller: class {
save() { this.close({ ok: true }); }
},
render() {
return `<p>Ventana flotante independiente.</p>
<button onclick="save()">Guardar</button>`;
}
});
Layout padre con <router-outlet> y rutas hijas que heredan automáticamente el prefijo /admin y ejecutan middleware.
const AppRouter = ScopeJS.Router([
{ path: "/", controller: HomePage },
{
path: "/admin",
controller: AdminLayout,
children: [
{ path: "/dashboard", controller: Dashboard },
{ path: "/usuarios/:id", controller: UserDetail }
]
}
], { useHash: true });
AppRouter.render(document.getElementById("app"));
Propiedades de Component, opciones de Modal arrastrable, Router SPA, rutas anidadas con <router-outlet> y utilidades.
Evolución desde v1.0 hasta v2.0.8: rutas anidadas, modo ventana, arrastre inteligente y definiciones TypeScript.