@jsweb/ui 1.2.6 → 1.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -14
- package/package.json +8 -24
- package/.github/workflows/npm-publish.yml +0 -21
- package/.prettierignore +0 -3
- package/.prettierrc +0 -7
- package/HISTORY.md +0 -36
- package/PROJECT.md +0 -90
- package/dist/LICENSE +0 -21
- package/dist/README.md +0 -104
- package/dist/package.json +0 -34
- package/index.html +0 -162
- package/publish.js +0 -34
- package/src/evaluator.ts +0 -29
- package/src/index.ts +0 -10
- package/src/parser.ts +0 -426
- package/src/reactivity.ts +0 -177
- package/tsconfig.json +0 -23
- package/vite.config.ts +0 -16
- /package/{dist/index.d.ts → index.d.ts} +0 -0
- /package/{dist/index.es.js → index.es.js} +0 -0
- /package/{dist/index.es.js.map → index.es.js.map} +0 -0
- /package/{dist/index.umd.js → index.umd.js} +0 -0
- /package/{dist/index.umd.js.map → index.umd.js.map} +0 -0
- /package/{dist/src → src}/evaluator.d.ts +0 -0
- /package/{dist/src → src}/index.d.ts +0 -0
- /package/{dist/src → src}/parser.d.ts +0 -0
- /package/{dist/src → src}/reactivity.d.ts +0 -0
- /package/{dist/vite.config.d.ts → vite.config.d.ts} +0 -0
package/README.md
CHANGED
|
@@ -32,17 +32,17 @@ npm i @jsweb/ui
|
|
|
32
32
|
|
|
33
33
|
O framework utiliza um sistema de atributos customizados para declaratividade no HTML.
|
|
34
34
|
|
|
35
|
-
| Diretiva
|
|
36
|
-
|
|
|
37
|
-
| `ui:scope`
|
|
38
|
-
| `ui:text`
|
|
39
|
-
| `:attr`
|
|
40
|
-
| `:class` / `:style`
|
|
41
|
-
| `@event`
|
|
42
|
-
| `$emit`
|
|
43
|
-
| `:bind`
|
|
44
|
-
| `ui:if`
|
|
45
|
-
| `ui:for`
|
|
35
|
+
| Diretiva | Descrição | Exemplo |
|
|
36
|
+
| :-------------------- | :------------------------------------------------------------------------------ | :------------------------------------ |
|
|
37
|
+
| `ui:scope` / `:scope` | Define o objeto de estado para o elemento e seus filhos. | `<div :scope="{ count: 0 }">` |
|
|
38
|
+
| `ui:text` / `:text` | Sincroniza o `textContent` com uma variável. | `<span :text="count"></span>` |
|
|
39
|
+
| `:attr` | Shorthand para bind de atributos HTML nativos. | `<button :disabled="count > 10">` |
|
|
40
|
+
| `:class` / `:style` | Bind dinâmico avançado para classes CSS e Estilos Inline (dicionários, arrays). | `<div :class="{ active: isActive }">` |
|
|
41
|
+
| `@event` | Shorthand para event listeners (com suporte a modificadores). | `<button @click.prevent="save">` |
|
|
42
|
+
| `$emit` | Despacha CustomEvents a partir do escopo atual. (Exposto no contexto) | `<button @click="$emit('custom')">` |
|
|
43
|
+
| `:bind` | Two-way data binding para inputs, checkboxes, radios e selects. | `<input :bind="name">` |
|
|
44
|
+
| `ui:if` / `:if` | Adiciona/Remove o elemento do DOM (via Comment Node placeholder). | `<div :if="count > 0">` |
|
|
45
|
+
| `ui:for` / `:for` | Renderiza uma lista de elementos a partir de um array. | `<li :for="item in items">` |
|
|
46
46
|
|
|
47
47
|
## Exemplo de Uso
|
|
48
48
|
|
|
@@ -86,9 +86,9 @@ O framework utiliza um sistema de atributos customizados para declaratividade no
|
|
|
86
86
|
### TypeScript / ESM
|
|
87
87
|
|
|
88
88
|
```typescript
|
|
89
|
-
import { createScope } from '@jsweb/ui'
|
|
89
|
+
import { createScope, reactive, watch } from '@jsweb/ui'
|
|
90
90
|
|
|
91
|
-
const scope = {
|
|
91
|
+
const scope = reactive({
|
|
92
92
|
count: 0,
|
|
93
93
|
inc: 'Incremento',
|
|
94
94
|
dec: 'Decremento',
|
|
@@ -98,7 +98,11 @@ const scope = {
|
|
|
98
98
|
decrement() {
|
|
99
99
|
this.count--
|
|
100
100
|
},
|
|
101
|
-
}
|
|
101
|
+
})
|
|
102
|
+
|
|
103
|
+
watch(() => scope.count, (newVal, oldVal) => {
|
|
104
|
+
console.log(`Contador mudou de ${oldVal} para ${newVal}`)
|
|
105
|
+
})
|
|
102
106
|
|
|
103
107
|
createScope('#container', { scope })
|
|
104
108
|
```
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jsweb/ui",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.7",
|
|
4
4
|
"description": "JS Web Microframework",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"js",
|
|
@@ -21,30 +21,14 @@
|
|
|
21
21
|
"license": "MIT",
|
|
22
22
|
"author": "Alex Bruno Cáceres <email@alexbruno.dev>",
|
|
23
23
|
"type": "module",
|
|
24
|
-
"main": "
|
|
25
|
-
"module": "
|
|
26
|
-
"types": "
|
|
24
|
+
"main": "index.umd.js",
|
|
25
|
+
"module": "index.es.js",
|
|
26
|
+
"types": "index.d.ts",
|
|
27
27
|
"exports": {
|
|
28
28
|
".": {
|
|
29
|
-
"import": "./
|
|
30
|
-
"require": "./
|
|
31
|
-
"types": "./
|
|
29
|
+
"import": "./index.es.js",
|
|
30
|
+
"require": "./index.umd.js",
|
|
31
|
+
"types": "./index.d.ts"
|
|
32
32
|
}
|
|
33
|
-
},
|
|
34
|
-
"scripts": {
|
|
35
|
-
"dev": "vite",
|
|
36
|
-
"build": "tsc && vite build && node publish.js",
|
|
37
|
-
"preview": "vite preview",
|
|
38
|
-
"format": "prettier --write .",
|
|
39
|
-
"test": "echo 'test'",
|
|
40
|
-
"preversion": "npm run build",
|
|
41
|
-
"postversion": "git push && git push --tags"
|
|
42
|
-
},
|
|
43
|
-
"devDependencies": {
|
|
44
|
-
"prettier": "^3.8.3",
|
|
45
|
-
"terser": "^5.46.2",
|
|
46
|
-
"typescript": "^6.0.3",
|
|
47
|
-
"vite": "^8.0.10",
|
|
48
|
-
"vite-plugin-dts": "^5.0.0"
|
|
49
33
|
}
|
|
50
|
-
}
|
|
34
|
+
}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
name: NPM Publish
|
|
2
|
-
|
|
3
|
-
on:
|
|
4
|
-
push:
|
|
5
|
-
tags:
|
|
6
|
-
- v*
|
|
7
|
-
|
|
8
|
-
jobs:
|
|
9
|
-
publish:
|
|
10
|
-
runs-on: ubuntu-latest
|
|
11
|
-
steps:
|
|
12
|
-
- uses: actions/checkout@v6
|
|
13
|
-
- uses: actions/setup-node@v6
|
|
14
|
-
with:
|
|
15
|
-
node-version: 22
|
|
16
|
-
registry-url: https://registry.npmjs.org/
|
|
17
|
-
- run: npm i
|
|
18
|
-
- run: npm run build
|
|
19
|
-
- run: npm publish ./dist --access public
|
|
20
|
-
env:
|
|
21
|
-
NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
|
package/.prettierignore
DELETED
package/.prettierrc
DELETED
package/HISTORY.md
DELETED
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# JS Web UI - Histórico de Desenvolvimento
|
|
2
|
-
|
|
3
|
-
Este documento serve como contexto histórico de todas as funcionalidades implementadas até o momento no **@jsweb/ui**, um micro-framework reativo, livre de dependências, de alta performance e sem Virtual DOM.
|
|
4
|
-
|
|
5
|
-
## 🧠 1. Core de Reatividade (`src/reactivity.ts`)
|
|
6
|
-
Construímos um motor baseado em **Signals** usando `Proxy` para interceptar leituras (`track`) e escritas (`trigger`).
|
|
7
|
-
- **Arquitetura `ReactiveEffect`:** A reatividade é gerenciada pela classe `ReactiveEffect`, permitindo controle refinado sobre o ciclo de vida dos efeitos (`stop`, `cleanup`) e garantindo limpeza eficiente de dependências para evitar vazamentos de memória. Também inclui micro-otimizações no rastreamento do Proxy para evitar buscas redundantes.
|
|
8
|
-
- **Deep Reactivity:** A reatividade funciona recursivamente em objetos profundamente aninhados.
|
|
9
|
-
- **Arrays e Mutabilidade:** Tratamento especial para arrays, onde a adição ou remoção de itens notifica dependências sobre a propriedade `length`, o que garante que loops reajam adequadamente a `.push`, `.pop`, etc.
|
|
10
|
-
- **Transparência:** O usuário final trabalha com dados mutáveis puros sem a necessidade de getters/setters explícitos (ex: `state.count++` em vez de `state.count.value++`).
|
|
11
|
-
|
|
12
|
-
## ⚙️ 2. Motor de Avaliação (`src/evaluator.ts`)
|
|
13
|
-
As expressões declaradas no HTML (ex: `:text="count + 1"`) são avaliadas de forma dinâmica.
|
|
14
|
-
- **Execução Sandboxed Contextual:** Utilização do bloco `with(this)` dentro de `new Function` para permitir que expressões acessem propriedades do contexto diretamente, sem poluir o escopo global.
|
|
15
|
-
- **Passagem Implícita e Explícita de Eventos:** O método `evaluateEvent` permite o uso de `$event` explícito (ex: `@click="log($event)"`) e também mapeia automaticamente a injeção do evento caso o usuário declare apenas o nome da função (ex: `@click="log"`).
|
|
16
|
-
|
|
17
|
-
## 🔤 3. Parser de Diretivas e DOM (`src/parser.ts`)
|
|
18
|
-
Em vez de Virtual DOM, manipulamos o DOM real empacotando atualizações através da função `effect`. O Parser lê o HTML e amarra os `effects`.
|
|
19
|
-
|
|
20
|
-
- **`:scope` (ou `ui:scope`):** Criação de escopos aninhados utilizando um esquema de herança de contextos (`createContext`) suportado por Proxies, permitindo "sombreamento" de propriedades corretas.
|
|
21
|
-
- **`:text`:** Renderização de conteúdo reativo como `textContent`.
|
|
22
|
-
- **`:if`:** Renderização condicional. O framework usa "âncoras" (`Comment Nodes`) para substituir dinamicamente o elemento no DOM quando a condição é falsa e restaurá-lo na posição exata quando for verdadeira.
|
|
23
|
-
- **`:for` e Reconciliação:** Renderização de listas utilizando algoritmo de *diffing*. O motor rastreia chaves (`:key` ou fallback para índice) de cada elemento gerado e reutiliza os mesmos nós DOM (`RenderedNode`). Isso traz performance massiva e garante que atributos nativos do navegador (ex: foco de um input) não se percam em mudanças reativas do array.
|
|
24
|
-
- **Atributos Genéricos (`:attr`):** Transformação dinâmica de qualquer atributo. Valores booleanos injetam/removem o atributo (ex: `disabled`).
|
|
25
|
-
- **Classes e Estilos Dinâmicos (`:class`, `:style`):** Suporte nativo a dicionários, arrays e strings lógicas para manipulação avançada de classes e estilos (ex: `:class="{ 'is-active': active }"`).
|
|
26
|
-
- **Eventos (`@event` e Modificadores):** Adição simples de ouvintes a qualquer evento DOM nativo. Inclui suporte nativo a **modificadores encadeados** com sintaxe de ponto (ex: `@submit.prevent`, `@click.stop`, `@click.self`, `@click.outside`) para um controle declarativo do comportamento do evento.
|
|
27
|
-
- **Eventos Customizados (`$emit`):** Injeção automática da função `$emit` em todos os escopos criados. Permite que componentes despachem `CustomEvents` nativos na árvore do DOM, facilitando a comunicação entre escopos (`@custom-event`).
|
|
28
|
-
- **Two-way Data Binding (`:bind`):** Suporte total a reatividade bidirecional (Tela <-> Estado) para `input[text]`, `input[checkbox]`, `input[radio]`, `<select>` e `<textarea>`. Sincroniza em tempo real tanto via evento `input` quanto `change`.
|
|
29
|
-
|
|
30
|
-
## 📦 4. Build e Bundling (`vite.config.ts`)
|
|
31
|
-
- O framework está formatado como uma biblioteca agnóstica para ser consumida como script direto ou módulo ESM via NPM.
|
|
32
|
-
- **Vite + Terser:** Optamos explicitamente por usar o *terser* em vez do *oxc* na etapa de minificação para atingir o nível máximo de compressão (cerca de ~1.8kB gzipped no estágio atual).
|
|
33
|
-
- Geração automática de pacotes de tipagem (`dts`).
|
|
34
|
-
|
|
35
|
-
## 🎯 Próximos Passos (Backlog Futuro Sugerido)
|
|
36
|
-
Para outros agentes, o framework atingiu um nível excepcional de maturidade (versão 0.2.0-ready). Os próximos passos lógicos envolvem a criação de testes unitários extensivos e a refatoração ou criação de um sistema robusto de roteamento e componentização via Web Components nativos, integrando esta sintaxe ao shadow DOM.
|
package/PROJECT.md
DELETED
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
# Especificação Técnica: Micro-Framework JS/TS (Codinome: @jsweb/ui)
|
|
2
|
-
|
|
3
|
-
## 1. Visão Geral
|
|
4
|
-
|
|
5
|
-
**@jsweb/ui** é um micro-framework frontend focado em _Progressive Enhancement_ e DX (Developer Experience). Ele deve oferecer a reatividade moderna de frameworks como Vue 3 (Composition API) e a simplicidade de uso direto no HTML do Alpine.js, sem a necessidade obrigatória de um build step, mas totalmente otimizado para árvores de dependência (tree-shaking) quando usado em ambientes build-tooling.
|
|
6
|
-
|
|
7
|
-
## 2. Pilares Arquiteturais
|
|
8
|
-
|
|
9
|
-
- **No Virtual DOM:** Utilização de reatividade de grão fino (Fine-grained reactivity) via `Proxy` ou `Signals`. Atualizações diretas no DOM real.
|
|
10
|
-
- **Dual Distribution:**
|
|
11
|
-
- **Standalone:** Arquivo único (IIFE/UMD) para inclusão via `<script src="...">`.
|
|
12
|
-
- **Module:** Pacote ESM com exports nomeados para suporte a Tree-Shaking.
|
|
13
|
-
- **Hybrid Context:** Suporte a definição de estado via Objetos Literais (POJOs) ou Classes TypeScript.
|
|
14
|
-
- **Template Engine:** Baseado em atributos customizados no HTML (`ui:*` para diretivas e `ui@*` para eventos, com shorthands `@`, `:`).
|
|
15
|
-
|
|
16
|
-
## 3. Especificações do Motor (Core)
|
|
17
|
-
|
|
18
|
-
### A. Sistema de Reatividade
|
|
19
|
-
|
|
20
|
-
- **Mecanismo:** Proxy-based em conjunto com a classe `ReactiveEffect`. O estado é interceptado para disparar "efeitos" com gerenciamento preciso de dependências, controle de ciclo de vida (`stop`, `cleanup`) e otimizado contra vazamento de memória.
|
|
21
|
-
- **Global State:** Deve ser possível exportar um objeto reativo de um arquivo e importá-lo em múltiplos componentes/contextos, tornando-o um estado compartilhado.
|
|
22
|
-
- **Global Effect:** Deve ser possível criar efeitos globais que reajam a mudanças em qualquer estado compartilhado.
|
|
23
|
-
- **Local State:** Deve ser possível criar estados locais que reajam a mudanças apenas dentro do escopo do componente.
|
|
24
|
-
- **Local Effect:** Deve ser possível criar efeitos locais que reajam a mudanças apenas dentro do escopo do componente.
|
|
25
|
-
- **Lifecycle:** Deve ser possível criar efeitos que reajam a mudanças no ciclo de vida do componente.
|
|
26
|
-
- **Cleanup:** Deve ser possível limpar os efeitos quando os componentes forem removidos do DOM.
|
|
27
|
-
- **Watchers:** Deve ser possível criar watchers que reajam a mudanças em propriedades específicas do estado.
|
|
28
|
-
- **Computed:** Deve ser possível criar propriedades computadas que reajam a mudanças em propriedades específicas do estado.
|
|
29
|
-
- **Composition API:** Deve ser possível usar a Composition API para criar efeitos e reatividade e aninhar efeitos e reatividade em outros efeitos e reatividade.
|
|
30
|
-
|
|
31
|
-
### B. Avaliador de Expressões (The Evaluator)
|
|
32
|
-
|
|
33
|
-
- **Implementação:** Uso de `new Function()` com `with(this)`.
|
|
34
|
-
- **Estratégia de Execução:** Para avaliar expressões declaradas no HTML de forma encapsulada (sandboxed):
|
|
35
|
-
1. O motor encapsula o objeto/escopo em um Proxy de Contexto para resolução de dependências.
|
|
36
|
-
2. Constrói a função dinâmica: `new Function('with(this) { ... }')`.
|
|
37
|
-
3. Executa a função passando o escopo reativo atrelado ao `this`.
|
|
38
|
-
4. Para eventos, também expõe a variável nativa `$event`.
|
|
39
|
-
|
|
40
|
-
### C. Parser de Template
|
|
41
|
-
|
|
42
|
-
- **Traversal:** Utilizar `TreeWalker` ou recursão otimizada para identificar diretivas.
|
|
43
|
-
- **Limpeza:** Atributos `ui:*`, `ui:@*`, `@*` e `:*` devem ser removidos do DOM após a inicialização para manter o HTML limpo.
|
|
44
|
-
|
|
45
|
-
## 4. Sintaxe e Diretivas (v0.1.0)
|
|
46
|
-
|
|
47
|
-
| Diretiva | Descrição | Exemplo |
|
|
48
|
-
| :------------------- | :----------------------------------------------------------------------------- | :------------------------------------ |
|
|
49
|
-
| `ui:scope` | Define o objeto de estado para o elemento e seus filhos. | `<div ui:scope="{ count: 0 }">` |
|
|
50
|
-
| `ui:text` | Sincroniza o `textContent` com uma variável. | `<span ui:text="count"></span>` |
|
|
51
|
-
| `:attr` | Shorthand para bind de atributos HTML nativos. | `<button :disabled="count > 10">` |
|
|
52
|
-
| `:class` / `:style` | Bind dinâmico avançado para classes CSS e Estilos Inline (dicionários, arrays).| `<div :class="{ active: isActive }">` |
|
|
53
|
-
| `@event` | Shorthand para event listeners (com suporte a modificadores). | `<button @click.prevent="save">` |
|
|
54
|
-
| `$emit` | Despacha CustomEvents a partir do escopo atual. (Exposto no contexto) | `<button @click="$emit('custom')">` |
|
|
55
|
-
| `:bind` | Two-way data binding para inputs, checkboxes, radios e selects. | `<input :bind="name">` |
|
|
56
|
-
| `ui:if` | Adiciona/Remove o elemento do DOM (via Comment Node placeholder). | `<div ui:if="count > 0">` |
|
|
57
|
-
| `ui:for` | Renderiza uma lista de elementos a partir de um array. | `<li ui:for="item in items">` |
|
|
58
|
-
|
|
59
|
-
## 5. Requisitos de Engenharia (Instruções para a IA)
|
|
60
|
-
|
|
61
|
-
- **Linguagem:** TypeScript Estrito.
|
|
62
|
-
- **Bundle Tool:** Vite (configurado para `build.lib` com formatos `es` e `umd`).
|
|
63
|
-
- **Memory Management:** Garantir o `cleanup` de event listeners e observadores quando elementos `ui:if` ou `ui:for` forem removidos.
|
|
64
|
-
- **Zero Dependencies:** O core não deve ter dependências externas de runtime.
|
|
65
|
-
- **Estilo de Código:** Funcional, modular, com comentários JSDoc claros para explicar o funcionamento interno do Proxy, do Parser e das diretivas.
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
### Stack de Build (Vite)
|
|
70
|
-
|
|
71
|
-
Para o `vite.config.ts`, utilize esta abordagem para satisfazer os requisitos de "Standalone" e "Module":
|
|
72
|
-
|
|
73
|
-
```typescript
|
|
74
|
-
import { defineConfig } from 'vite'
|
|
75
|
-
import dts from 'vite-plugin-dts'
|
|
76
|
-
|
|
77
|
-
export default defineConfig({
|
|
78
|
-
build: {
|
|
79
|
-
lib: {
|
|
80
|
-
entry: './src/index.ts',
|
|
81
|
-
name: 'jswebui',
|
|
82
|
-
fileName: (format) => `ui.${format}.js`,
|
|
83
|
-
formats: ['es', 'umd'],
|
|
84
|
-
},
|
|
85
|
-
sourcemap: true,
|
|
86
|
-
minify: 'terser',
|
|
87
|
-
},
|
|
88
|
-
plugins: [dts()], // Gera os tipos .d.ts automaticamente
|
|
89
|
-
})
|
|
90
|
-
```
|
package/dist/LICENSE
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 jsweb
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
package/dist/README.md
DELETED
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
# @jsweb/ui
|
|
2
|
-
|
|
3
|
-
## Introdução
|
|
4
|
-
|
|
5
|
-
O `@jsweb/ui` é um micro-framework frontend escrito em TypeScript, projetado para ser uma ferramenta leve, rápida e flexível para o desenvolvimento de interfaces de usuário. Ele combina a reatividade moderna de frameworks como Vue 3 (Composition API) com a simplicidade de uso direto no HTML, semelhante ao Alpine.js.
|
|
6
|
-
|
|
7
|
-
### Pilares Arquiteturais
|
|
8
|
-
|
|
9
|
-
- **Sem Virtual DOM**: Utiliza reatividade de grão fino (Fine-grained reactivity) via `Proxy` para atualizações diretas no DOM real.
|
|
10
|
-
- **Distribuição Dupla**:
|
|
11
|
-
- **Standalone**: Arquivo único (IIFE/UMD) para inclusão via `<script src="...">`.
|
|
12
|
-
- **Module**: Pacote ESM com exports nomeados para suporte a Tree-Shaking.
|
|
13
|
-
- **Contexto Híbrido**: Suporta definição de estado via Objetos Literais (POJOs) ou Classes TypeScript.
|
|
14
|
-
- **Template Engine**: Baseado em atributos customizados no HTML (`ui:*` para diretivas e `ui@*` para eventos, com shorthands `@`, `:`).
|
|
15
|
-
- Suporte completo a **modificadores de eventos** encadeados (`.prevent`, `.stop`, `.self`, `.outside`).
|
|
16
|
-
|
|
17
|
-
## Instalação
|
|
18
|
-
|
|
19
|
-
### NPM
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
npm i @jsweb/ui
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### CDN
|
|
26
|
-
|
|
27
|
-
```html
|
|
28
|
-
<script src="https://unpkg.com/@jsweb/ui"></script>
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## Diretivas Disponíveis (v0.1.0)
|
|
32
|
-
|
|
33
|
-
O framework utiliza um sistema de atributos customizados para declaratividade no HTML.
|
|
34
|
-
|
|
35
|
-
| Diretiva | Descrição | Exemplo |
|
|
36
|
-
| :------------------ | :------------------------------------------------------------------------------ | :------------------------------------ |
|
|
37
|
-
| `ui:scope` | Define o objeto de estado para o elemento e seus filhos. | `<div ui:scope="{ count: 0 }">` |
|
|
38
|
-
| `ui:text` | Sincroniza o `textContent` com uma variável. | `<span ui:text="count"></span>` |
|
|
39
|
-
| `:attr` | Shorthand para bind de atributos HTML nativos. | `<button :disabled="count > 10">` |
|
|
40
|
-
| `:class` / `:style` | Bind dinâmico avançado para classes CSS e Estilos Inline (dicionários, arrays). | `<div :class="{ active: isActive }">` |
|
|
41
|
-
| `@event` | Shorthand para event listeners (com suporte a modificadores). | `<button @click.prevent="save">` |
|
|
42
|
-
| `$emit` | Despacha CustomEvents a partir do escopo atual. (Exposto no contexto) | `<button @click="$emit('custom')">` |
|
|
43
|
-
| `:bind` | Two-way data binding para inputs, checkboxes, radios e selects. | `<input :bind="name">` |
|
|
44
|
-
| `ui:if` | Adiciona/Remove o elemento do DOM (via Comment Node placeholder). | `<div ui:if="count > 0">` |
|
|
45
|
-
| `ui:for` | Renderiza uma lista de elementos a partir de um array. | `<li ui:for="item in items">` |
|
|
46
|
-
|
|
47
|
-
## Exemplo de Uso
|
|
48
|
-
|
|
49
|
-
### HTML
|
|
50
|
-
|
|
51
|
-
```html
|
|
52
|
-
<!DOCTYPE html>
|
|
53
|
-
<html lang="en">
|
|
54
|
-
<head>
|
|
55
|
-
<meta charset="UTF-8" />
|
|
56
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
57
|
-
<title>JS Web UI</title>
|
|
58
|
-
<script src="https://unpkg.com/@jsweb/ui"></script>
|
|
59
|
-
<script>
|
|
60
|
-
const scope = {
|
|
61
|
-
count: 0,
|
|
62
|
-
inc: 'Incremento',
|
|
63
|
-
dec: 'Decremento',
|
|
64
|
-
increment() {
|
|
65
|
-
this.count++
|
|
66
|
-
},
|
|
67
|
-
decrement() {
|
|
68
|
-
this.count--
|
|
69
|
-
},
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
jsweb.ui.createScope('body', { scope })
|
|
73
|
-
</script>
|
|
74
|
-
</head>
|
|
75
|
-
<body>
|
|
76
|
-
<div ui:scope="scope">
|
|
77
|
-
<h1>JS Web UI</h1>
|
|
78
|
-
<p>Contador: <span ui:text="count"></span></p>
|
|
79
|
-
<button ui:text="inc" @click="increment()"></button>
|
|
80
|
-
<button ui:text="dec" @click="decrement()"></button>
|
|
81
|
-
</div>
|
|
82
|
-
</body>
|
|
83
|
-
</html>
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
### TypeScript / ESM
|
|
87
|
-
|
|
88
|
-
```typescript
|
|
89
|
-
import { createScope } from '@jsweb/ui'
|
|
90
|
-
|
|
91
|
-
const scope = {
|
|
92
|
-
count: 0,
|
|
93
|
-
inc: 'Incremento',
|
|
94
|
-
dec: 'Decremento',
|
|
95
|
-
increment() {
|
|
96
|
-
this.count++
|
|
97
|
-
},
|
|
98
|
-
decrement() {
|
|
99
|
-
this.count--
|
|
100
|
-
},
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
createScope('#container', { scope })
|
|
104
|
-
```
|
package/dist/package.json
DELETED
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@jsweb/ui",
|
|
3
|
-
"version": "1.2.5",
|
|
4
|
-
"description": "JS Web Microframework",
|
|
5
|
-
"keywords": [
|
|
6
|
-
"js",
|
|
7
|
-
"ts",
|
|
8
|
-
"web",
|
|
9
|
-
"ui",
|
|
10
|
-
"micro",
|
|
11
|
-
"framework"
|
|
12
|
-
],
|
|
13
|
-
"homepage": "https://github.com/jsweb/ui#readme",
|
|
14
|
-
"bugs": {
|
|
15
|
-
"url": "https://github.com/jsweb/ui/issues"
|
|
16
|
-
},
|
|
17
|
-
"repository": {
|
|
18
|
-
"type": "git",
|
|
19
|
-
"url": "git+https://github.com/jsweb/ui.git"
|
|
20
|
-
},
|
|
21
|
-
"license": "MIT",
|
|
22
|
-
"author": "Alex Bruno Cáceres <email@alexbruno.dev>",
|
|
23
|
-
"type": "module",
|
|
24
|
-
"main": "index.umd.js",
|
|
25
|
-
"module": "index.es.js",
|
|
26
|
-
"types": "index.d.ts",
|
|
27
|
-
"exports": {
|
|
28
|
-
".": {
|
|
29
|
-
"import": "./index.es.js",
|
|
30
|
-
"require": "./index.umd.js",
|
|
31
|
-
"types": "./index.d.ts"
|
|
32
|
-
}
|
|
33
|
-
}
|
|
34
|
-
}
|
package/index.html
DELETED
|
@@ -1,162 +0,0 @@
|
|
|
1
|
-
<!doctype html>
|
|
2
|
-
<html lang="en">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8" />
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
|
-
<title>JS Web UI Test</title>
|
|
7
|
-
<style>
|
|
8
|
-
.box {
|
|
9
|
-
padding: 20px;
|
|
10
|
-
border-radius: 8px;
|
|
11
|
-
transition: all 0.3s ease;
|
|
12
|
-
margin-bottom: 10px;
|
|
13
|
-
color: white;
|
|
14
|
-
}
|
|
15
|
-
.active {
|
|
16
|
-
box-shadow: 0 0 15px rgba(0, 0, 0, 0.3);
|
|
17
|
-
transform: scale(1.02);
|
|
18
|
-
}
|
|
19
|
-
</style>
|
|
20
|
-
<script type="module">
|
|
21
|
-
import { createScope, reactive } from '/src/index.ts'
|
|
22
|
-
|
|
23
|
-
const scope = reactive({
|
|
24
|
-
count: 0,
|
|
25
|
-
inc: 'Incremento',
|
|
26
|
-
dec: 'Decremento',
|
|
27
|
-
model: 'Exemplo',
|
|
28
|
-
items: ['A', 'B', 'C'],
|
|
29
|
-
active: false,
|
|
30
|
-
color: '#42b883',
|
|
31
|
-
|
|
32
|
-
get computedItems() {
|
|
33
|
-
return this.items.map((value, index) => {
|
|
34
|
-
return { value, index }
|
|
35
|
-
})
|
|
36
|
-
},
|
|
37
|
-
|
|
38
|
-
increment() {
|
|
39
|
-
this.count++
|
|
40
|
-
},
|
|
41
|
-
decrement() {
|
|
42
|
-
this.count--
|
|
43
|
-
},
|
|
44
|
-
zero() {
|
|
45
|
-
this.count = 0
|
|
46
|
-
},
|
|
47
|
-
addItem() {
|
|
48
|
-
const value = Date.now()
|
|
49
|
-
this.items.push(value)
|
|
50
|
-
},
|
|
51
|
-
removeItem() {
|
|
52
|
-
this.items.pop()
|
|
53
|
-
},
|
|
54
|
-
logEvent(e, ...args) {
|
|
55
|
-
console.log('Evento recebido:', e, args)
|
|
56
|
-
this.items.push(`Evento ${e.type}`)
|
|
57
|
-
},
|
|
58
|
-
toggleActive() {
|
|
59
|
-
this.active = !this.active
|
|
60
|
-
},
|
|
61
|
-
handleCustomEvent(e) {
|
|
62
|
-
alert(`Custom event received: ${e.detail.message}`)
|
|
63
|
-
this.items.push(`Custom Event: ${e.detail.message}`)
|
|
64
|
-
},
|
|
65
|
-
})
|
|
66
|
-
|
|
67
|
-
window.scope = scope
|
|
68
|
-
|
|
69
|
-
createScope('body', { scope })
|
|
70
|
-
</script>
|
|
71
|
-
</head>
|
|
72
|
-
<body>
|
|
73
|
-
<div :scope="scope">
|
|
74
|
-
<h1>JS Web UI</h1>
|
|
75
|
-
<p>Contador: <span :text="count"></span></p>
|
|
76
|
-
<button :text="inc" @click="increment">+</button>
|
|
77
|
-
<button :text="dec" @click="decrement">-</button>
|
|
78
|
-
|
|
79
|
-
<div style="margin-top: 20px">
|
|
80
|
-
<button @click="zero" :disabled="!count">Zerar</button>
|
|
81
|
-
</div>
|
|
82
|
-
|
|
83
|
-
<div
|
|
84
|
-
:if="count > 0"
|
|
85
|
-
style="margin-top: 20px; padding: 10px; border: 1px solid green"
|
|
86
|
-
>
|
|
87
|
-
O contador é maior que zero!
|
|
88
|
-
</div>
|
|
89
|
-
|
|
90
|
-
<div style="margin-top: 20px">
|
|
91
|
-
<h3>Lista:</h3>
|
|
92
|
-
<div style="margin-bottom: 10px">
|
|
93
|
-
<input type="text" :bind="model" placeholder="Digite algo..." />
|
|
94
|
-
<p>Você vai adicionar: <strong :text="model"></strong></p>
|
|
95
|
-
<button @click="addItem">Adicionar Item</button>
|
|
96
|
-
<button @click="removeItem">Remover Item</button>
|
|
97
|
-
<button @click="logEvent">Testar Evento (Sem Parênteses)</button>
|
|
98
|
-
<button @click="logEvent($event, 'A', 'B', 'C')">
|
|
99
|
-
Testar Evento (Com Parênteses)
|
|
100
|
-
</button>
|
|
101
|
-
</div>
|
|
102
|
-
<ul>
|
|
103
|
-
<li :for="item of computedItems">
|
|
104
|
-
<span :text="item.index"></span>
|
|
105
|
-
<input type="text" :value="item.value" />
|
|
106
|
-
</li>
|
|
107
|
-
</ul>
|
|
108
|
-
</div>
|
|
109
|
-
|
|
110
|
-
<hr />
|
|
111
|
-
|
|
112
|
-
<div style="margin-top: 20px">
|
|
113
|
-
<h3>Testes de :class e :style</h3>
|
|
114
|
-
<div
|
|
115
|
-
class="box"
|
|
116
|
-
:class="{ active }"
|
|
117
|
-
:style="{ backgroundColor: color, opacity: count ? 1 : 0.5 }"
|
|
118
|
-
>
|
|
119
|
-
Caixa de teste! Ativa: <strong :text="active"></strong>
|
|
120
|
-
</div>
|
|
121
|
-
|
|
122
|
-
<div style="margin-top: 10px">
|
|
123
|
-
<button @click="toggleActive">Alternar Classe 'active'</button>
|
|
124
|
-
|
|
125
|
-
<label style="margin-left: 10px">
|
|
126
|
-
Cor de Fundo:
|
|
127
|
-
<input type="color" :bind="color" />
|
|
128
|
-
</label>
|
|
129
|
-
</div>
|
|
130
|
-
</div>
|
|
131
|
-
|
|
132
|
-
<hr />
|
|
133
|
-
|
|
134
|
-
<div style="margin-top: 20px" @custom-event="handleCustomEvent">
|
|
135
|
-
<h3>Teste de $emit (Comunicação de Eventos)</h3>
|
|
136
|
-
<p>A div pai está escutando <code>@custom-event</code>.</p>
|
|
137
|
-
|
|
138
|
-
<!-- Escopo Filho Simulado -->
|
|
139
|
-
<div
|
|
140
|
-
:scope="{ component: 'Componente Interno' }"
|
|
141
|
-
style="
|
|
142
|
-
padding: 0 15px 15px 15px;
|
|
143
|
-
border: 2px dashed silver;
|
|
144
|
-
margin-top: 10px;
|
|
145
|
-
"
|
|
146
|
-
>
|
|
147
|
-
<p>Nome interno: <strong :text="component"></strong></p>
|
|
148
|
-
<button
|
|
149
|
-
@click="
|
|
150
|
-
$emit(
|
|
151
|
-
'custom-event',
|
|
152
|
-
{ message: `Mensagem enviada do ${component}` },
|
|
153
|
-
)
|
|
154
|
-
"
|
|
155
|
-
>
|
|
156
|
-
Disparar evento para o pai
|
|
157
|
-
</button>
|
|
158
|
-
</div>
|
|
159
|
-
</div>
|
|
160
|
-
</div>
|
|
161
|
-
</body>
|
|
162
|
-
</html>
|
package/publish.js
DELETED
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
import { resolve } from 'node:path'
|
|
2
|
-
import { copyFileSync, readFileSync, writeFileSync } from 'node:fs'
|
|
3
|
-
|
|
4
|
-
const root = process.cwd()
|
|
5
|
-
const source = resolve(root, 'package.json')
|
|
6
|
-
const target = resolve(root, 'dist/package.json')
|
|
7
|
-
const pkgInfo = JSON.parse(readFileSync(source, 'utf8'))
|
|
8
|
-
|
|
9
|
-
// 1. Remove campos que não são necessários no pacote publicado
|
|
10
|
-
delete pkgInfo.scripts
|
|
11
|
-
delete pkgInfo.devDependencies
|
|
12
|
-
|
|
13
|
-
// 2. Ajusta os caminhos dos arquivos, pois o root do pacote agora será a pasta dist/
|
|
14
|
-
pkgInfo.main = 'index.umd.js'
|
|
15
|
-
pkgInfo.module = 'index.es.js'
|
|
16
|
-
pkgInfo.types = 'index.d.ts'
|
|
17
|
-
pkgInfo.exports = {
|
|
18
|
-
'.': {
|
|
19
|
-
import: './index.es.js',
|
|
20
|
-
require: './index.umd.js',
|
|
21
|
-
types: './index.d.ts',
|
|
22
|
-
},
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
// 3. Salva o package.json modificado dentro da pasta dist/
|
|
26
|
-
writeFileSync(target, JSON.stringify(pkgInfo, null, 2))
|
|
27
|
-
|
|
28
|
-
// 4. Copia arquivos de metadados importantes para o NPM
|
|
29
|
-
copyFileSync(resolve(root, 'README.md'), resolve(root, 'dist/README.md'))
|
|
30
|
-
copyFileSync(resolve(root, 'LICENSE'), resolve(root, 'dist/LICENSE'))
|
|
31
|
-
|
|
32
|
-
console.log(
|
|
33
|
-
'✅ Arquivo package.json mínimo e metadados preparados na pasta dist/',
|
|
34
|
-
)
|
package/src/evaluator.ts
DELETED
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
export function evaluate(
|
|
2
|
-
expression: string,
|
|
3
|
-
context: Record<string, any> = {},
|
|
4
|
-
) {
|
|
5
|
-
try {
|
|
6
|
-
const fn = new Function(`with(this) { return ${expression} }`)
|
|
7
|
-
return fn.call(context)
|
|
8
|
-
} catch {
|
|
9
|
-
return undefined
|
|
10
|
-
}
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
export function evaluateEvent(
|
|
14
|
-
$event: Event,
|
|
15
|
-
expression: string,
|
|
16
|
-
context: Record<string, any> = {},
|
|
17
|
-
) {
|
|
18
|
-
try {
|
|
19
|
-
const exp = expression.trim()
|
|
20
|
-
const isIdentifier = /^[a-zA-Z_$][0-9a-zA-Z_$.]*$/.test(exp)
|
|
21
|
-
const code = `${exp} instanceof Function ? ${exp}.call(this, $event) : ${exp}`
|
|
22
|
-
const result = isIdentifier ? code : exp
|
|
23
|
-
const fn = new Function('$event', `with(this) { ${result} }`)
|
|
24
|
-
|
|
25
|
-
fn.call(context, $event)
|
|
26
|
-
} catch {
|
|
27
|
-
console.warn(`[jsweb/ui] Error evaluating event: ${expression}`)
|
|
28
|
-
}
|
|
29
|
-
}
|