ScopeJS v2.0.8
v2.0.8 · Framework Reactivo Vanilla

Componentes reactivos sin build con ScopeJS

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
~15 KBminificado 0 depsvanilla JS Router + Modalincluidos Apache-2.0 · TStipado
Componente en vivo Component · DOM diff
ScopeJS.Componentapply() #1
4
-1+1Paso: 1Reset
Render quirúrgico · 1 nodo
ScopeJS.Component({ controller, render }).render(el);
Instalación rápida

Instala por npm o carga por CDN

Funciona como script clásico UMD, ES Modules o paquete npm sin transpilador ni bundler.

Con gestor de paquetes (npm)

npm · @pablotheblink/scopejs
bash / js
$ npm install @pablotheblink/scopejs

// ES Modules / TypeScript
import { Component, Modal, Router }
  from "@pablotheblink/scopejs";

// CommonJS
const { Component } = require(
  "@pablotheblink/scopejs");

Directo por CDN (unpkg)

index.html
html
<!-- 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>
Ejemplo rápido

Estado, plantilla y CSS scoped en una pieza

Define tu controlador en JavaScript estándar y llama a this.apply() para parchear únicamente lo que cambió.

counter.js
javascript
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"));
Demo interactiva

Componentes, modales y rutas en vivo

Prueba la instancia real de ScopeJS v2.0.8 o abre el configurador interactivo (/demo) →.

Instancia real ScopeJS
Cargando componente ScopeJS…
unpkg · @pablotheblink/scopejs@2.0.8 Data binding bidireccional
scope-tareas.js
javascript
// 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>`;
  }
});
Características

Todo lo necesario para una SPA moderna

Componentes, formularios reactivos, ventanas flotantes y enrutamiento jerárquico sin arrastrar dependencias.

Renderizado quirúrgico

Actualiza únicamente los nodos de texto y atributos que han cambiado al llamar a apply(), manteniendo el resto del DOM intacto.

Componentes encapsulados

Controlador en clase ES6, plantilla HTML, CSS scoped automático y ciclo de vida postRender en un único objeto declarativo.

Data binding bidireccional

El atributo model sincroniza inputs y propiedades anidadas (user.name) sin configuración adicional ni observadores pesados.

Modales y modo ventana

Sistema de ventanas emergentes con overlay, modo ventana sin bloqueo (windowMode), arrastre (draggable) y apilamiento z-index automático.

Router SPA y rutas anidadas

Navegación SPA con parámetros dinámicos (:id), middleware, herencia de prefijos y <router-outlet> para layouts compartidos.

~15 KB y cero dependencias

Compatible con ES Modules, CommonJS y script clásico UMD con declaraciones TypeScript oficiales en types/index.d.ts.

Recetas oficiales

Ejemplos listos para copiar

Patrones reales extraídos de la documentación de ScopeJS: contador, tareas, ventana arrastrable y rutas anidadas.

Contador reactivo

Component

Componente mínimo con estado en el controlador, paso configurable, CSS scoped y actualización quirúrgica mediante this.apply().

counter.js
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"));

Lista de tareas con model

Data binding

Sincronización automática de input con model="newTodo", filtros por estado y renderizado de colecciones en vanilla JS.

todo-list.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>`;
  }
});

Modal arrastrable y modo ventana

v2.0.6+

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.

modal-window.js
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>`;
  }
});

Router SPA con rutas anidadas

v2.0.5+

Layout padre con <router-outlet> y rutas hijas que heredan automáticamente el prefijo /admin y ejecutan middleware.

nested-router.js
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"));
Referencia técnica

Documentación y evolución del paquete

Referencia completa

Documentación y API

Propiedades de Component, opciones de Modal arrastrable, Router SPA, rutas anidadas con <router-outlet> y utilidades.

Abrir Docs API →
Historial de cambios

Changelog (v2.0.8)

Evolución desde v1.0 hasta v2.0.8: rutas anidadas, modo ventana, arrastre inteligente y definiciones TypeScript.

Ver historial de versiones →