nexa-framework 0.7.5 → 0.7.7

package/dist/ai-context.d.ts

@@ -0,0 +1 @@
+export declare function aiContext(): string;

package/dist/ai-context.js

@@ -0,0 +1,93 @@
+export function aiContext() {
+    return `# Nexa Framework — AI Context
+
+Framework frontend reactivo con Signals + Virtual DOM + SFC compiler (.nexa) + UI kit.
+
+## Paquetes
+- \`nexa-framework\` — Core (reactividad + VDOM + SSR + async + directivas)
+- \`nexa-ui-kit\` — 33 UI components
+- \`@nexa/router\` — SPA router
+- \`@nexa/state\` — State management
+
+## Reactividad
+\`\`\`ts
+signal<T>(init: T): Signal<T>    // { value: T, peek(): T }
+computed<T>(fn): Signal<T>
+effect(fn): Effect
+batch(fn): void
+untracked<T>(fn): T
+\`\`\`
+Siempre usa \`.value\` para leer/escribir señales.
+
+## VDOM
+\`\`\`ts
+h(tag, props?, children?): VNode
+mount(vnode, container): void
+defineComponent({ props?, emits?, setup?, render? })
+\`\`\`
+Lifecycle: onMounted, onBeforeMount, onUpdated, onBeforeUpdate, onUnmounted, onBeforeUnmount
+Provide/inject: provide(key, val), inject(key, default?)
+
+## SFC (.nexa)
+\`\`\`html
+<script setup>
+const count = signal(0)
+</script>
+<template>
+  <p>{{ count.value }}</p>
+  <button @click="count = count + 1">+</button>
+</template>
+<style scoped>
+p { color: blue; }
+</style>
+\`\`\`
+
+### Template directives
+- {{ expr }}, :attr, @event, @event.prevent/.stop/.self
+- v-if, v-else-if, v-else, v-for="item in items", v-show, v-model
+- v-currency (formato moneda)
+- #name para slots nombrados, scoped slots con { data }
+- Asignaciones inline: @click="x = expr" compila a x.value = expr
+
+### Componentes UI (nexa-ui-kit)
+NInput, NInputNumber(mode currency/props currency/locale), NPassword, NSelect, NMultiSelect,
+NAutocomplete, NCheckbox, NSwitch, NRadio, NChips, NDatepicker,
+NButton(variant/size/loading/block/disabled), NCard, NModal(size/closable), NBottomSheet, NTabs,
+NDataTable(columns/paginator/selection/sort), NPaginator, NTreeMenu,
+NAvatar, NTag, NBadge, NAlert, NToastContainer(useToast), NProgressBar, NSkeleton, NTooltip,
+NForm(rules), NFormField, NVirtualList, NScrollView, NImage
+v-model en inputs: <NInput v-model="signal" />
+
+### Router (@nexa/router)
+createRouter({ routes: [{path, component}], mode: 'history'|'hash' })
+router.navigate(path), router.beforeEach(guard)
+RouterView, Link componentes de template
+Señales: currentPath, params, query, loading
+
+### State (@nexa/state)
+createStore({ key: val }) → { state: { key: Signal } }
+defineStore(id, factory) → singleton composable
+persist(key, initial) → Signal con localStorage
+
+### Async
+defineAsyncComponent({ loader, loadingComponent, errorComponent, delay, timeout })
+Suspense, ErrorBoundary
+
+### SSR
+renderToString(vnode), hydrate(vnode, container)
+
+### Directives programáticas
+vShow(el, signal), vModel(vnode, signal), vCurrency(vnode, signal, {currency?, locale?})
+
+### Testing
+render(Component) → { container, baseElement, unmount }
+
+### Best Practices
+1. signal() para todo estado reactivo
+2. .value siempre (excepto peek() para leer sin tracking)
+3. Inline assignments: @click="x = expr" funciona (v0.7.6+)
+4. batch() para múltiples writes
+5. cleanup en effect()
+6. Max 200 líneas por componente
+7. Sin comentarios en código, arrow functions, early return, TDD`;
+}

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export { signal, computed, effect, batch, untracked, } from 'nexa-reactivity';
 export type { Signal } from 'nexa-reactivity';
 export { h, hText, Fragment, Teleport, mount, defineComponent, provide, inject, onBeforeMount, onMounted, onBeforeUpdate, onUpdated, onBeforeUnmount, onUnmounted, vShow, vModel, vCurrency, renderToString, registerComponent, reloadComponent, injectStyle, Suspense, ErrorBoundary, Transition, createRenderer, domOptions, } from 'nexa-runtime';
 export type { VNode, Component } from 'nexa-runtime';
+export { aiContext } from './ai-context.js';

package/dist/index.js

@@ -1,2 +1,3 @@
 export { signal, computed, effect, batch, untracked, } from 'nexa-reactivity';
 export { h, hText, Fragment, Teleport, mount, defineComponent, provide, inject, onBeforeMount, onMounted, onBeforeUpdate, onUpdated, onBeforeUnmount, onUnmounted, vShow, vModel, vCurrency, renderToString, registerComponent, reloadComponent, injectStyle, Suspense, ErrorBoundary, Transition, createRenderer, domOptions, } from 'nexa-runtime';
+export { aiContext } from './ai-context.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexa-framework",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -13,8 +13,8 @@
     }
   },
   "dependencies": {
-    "nexa-runtime": "0.7.5",
-    "nexa-reactivity": "0.7.5"
+    "nexa-runtime": "0.7.7",
+    "nexa-reactivity": "0.7.7"
   },
   "files": [
     "dist"