arckode-ui 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,102 @@
+# Changelog
+
+Cambios entre versiones publicadas. Sigue [keepachangelog](https://keepachangelog.com/) y [semver](https://semver.org/).
+
+## [Unreleased]
+
+## [0.2.2] — 2026-05-23
+
+### Fixed
+- **🔴 CRÍTICO**: el paquete ahora incluye archivos `.d.ts`. En `0.2.1` el `package.json`
+  declaraba `"types": "./dist/index.d.ts"` pero el archivo no existía — los consumidores
+  TypeScript recibían `any` en todos los imports. Se agregó `vite-plugin-dts` al build.
+- `package.json.exports["./vite"].types` ahora apunta al path real
+  `./dist/compiler/vite-plugin.d.ts` (antes apuntaba a un archivo inexistente).
+
+### Added
+- `.gitlab-ci.yml`: pipeline con stages `install → check → build`. Falla el push si:
+  tests rojos, type-check con errores, build no genera todos los artefactos, shebang del
+  CLI ausente o no ejecutable, examples con errores del analyzer.
+- `tools/analyze-examples.ts`: corre el analyzer sobre todos los `.ark` de `examples/`
+  y falla con exit 1 si hay errores. Usado por CI.
+- `CHANGELOG.md`: este archivo. Documenta cambios formalmente.
+
+### Changed
+- SKILL global + `skills/components/SKILL.md`: documentación explícita del trap del
+  store con `useStore()` auto-referencia y el patrón seguro alternativo (declarar el
+  useStore primero a nivel módulo y usarlo en getters/actions).
+
+## [0.2.1] — 2026-05-22
+
+### Added
+- `CLAUDE.md.example`: template que los consumidores copian a la raíz de su proyecto.
+  Activa el SKILL automáticamente para Claude Code / OpenCode / Cursor con un solo
+  comando: `cp node_modules/arckode-ui/CLAUDE.md.example ./CLAUDE.md`.
+- `BENCHMARK.md`: resultados del test ciego de predictabilidad con Claude Sonnet.
+  10 prompts × 2 variantes. Resultado: Sin SKILL 30% / Con SKILL 100%.
+- `tools/benchmark.ts` y `tools/prompts.ts`: script reproducible del benchmark
+  (requiere `ANTHROPIC_API_KEY`).
+- `tools/README.md`: instrucciones de uso del benchmark.
+- README con badge del benchmark y sección "Activar el SKILL para tu IA".
+
+## [0.2.0] — 2026-05-22
+
+### Added
+- **PROTOCOLO OBLIGATORIO** en el SKILL principal con PASO 1 → 4
+  (identificar alcance → verificar reglas → generar → verificar resultado).
+- **16 REGLAS INMUTABLES numeradas** (`REGLA #1` a `REGLA #16`), referenciables
+  desde los anti-patterns y el output del analyzer.
+- **Árboles de decisión** "Si te piden X, hacé Y" para 7 escenarios típicos:
+  crear componente, agregar estado, comunicar componentes, renderizar lista,
+  hacer fetch, modificar componente, resolver error del analyzer.
+- **Checklist post-código** con comandos exactos.
+- 6 sub-skills temáticos en `skills/` distribuidos con el paquete npm:
+  `runtime`, `compiler`, `analyzer`, `cli`, `components`, `testing`.
+- `CLAUDE.md` del repo reescrito con 10 REGLAS INMUTABLES para desarrolladores
+  del framework + protocolo de release de 5 pasos + checklist pre-release.
+
+### Changed
+- README actualizado para reflejar el nivel de predictabilidad apuntado.
+
+## [0.1.1] — 2026-05-22
+
+### Fixed
+- **🔴 CRÍTICO**: `package.json.bin` corregido a `dist/cli.js` (sin `./`).
+  npm rechazaba silenciosamente el campo `bin` con prefix `./` y eliminaba la entry —
+  resultado: `npx arckode-ui ark` no funcionaba en `0.1.0`. Verificable con `npm pack`.
+
+## [0.1.0] — 2026-05-22
+
+### Added — initial release
+
+- **Runtime**: `signal`, `computed`, `watch`, `effect`, `defineComponent`,
+  lifecycle hooks (`onMount`, `onUnmount`, `onUpdate`), `h`, `mount`, `mountComponent`.
+- **APIs**: `defineStore` (estado global con persist), `createService` (HTTP wrapper
+  con timeout y type safety), router client-side (`createRouter`, `navigate`,
+  `useRoute`, `getCurrentPath`).
+- **Compiler**: parser `.ark`, template-compiler con `v-if/v-else/v-else-if`, `v-for`,
+  `v-show`, `<slot />`, componentes PascalCase, modificadores de teclado, interpolación.
+- **Vite plugin**: `arkcodeUi()` desde subpath `arckode-ui/vite`.
+- **Analyzer estático**: 16 reglas detectando anti-patterns y violations estructurales,
+  cada una con campo `fix` que sugiere la corrección concreta. Bloquea builds de
+  producción si hay errors.
+- **CLI**: `ark new`, `ark generate {component, page, store, service, layout}`,
+  `ark analyze`, `ark routes`.
+- **Comunicación hijo→padre**: emit con `@event` handlers funcional (dispatch
+  como CustomEvent sin prefijo, wrapper del child registra listeners `onX`).
+- 314 tests pasando.
+- 2 ejemplos completos: `kitchen-sink` (demo de features) y `tasks` (app real
+  con sidebar, modal, form, validación, search con debounce).
+
+### Known issues at release
+- `package.json.bin` con sintaxis inválida que npm removía silenciosamente —
+  arreglado en `0.1.1`.
+- TypeScript declarations no se generaban (`vite-plugin-dts` faltaba) —
+  arreglado en `0.2.2`.
+
+[Unreleased]: https://gitlab.com/underworf/arckode-ui/-/compare/v0.2.2...HEAD
+[0.2.2]: https://gitlab.com/underworf/arckode-ui/-/compare/v0.2.1...v0.2.2
+[0.2.1]: https://gitlab.com/underworf/arckode-ui/-/compare/v0.2.0...v0.2.1
+[0.2.0]: https://gitlab.com/underworf/arckode-ui/-/compare/v0.1.1...v0.2.0
+[0.1.1]: https://gitlab.com/underworf/arckode-ui/-/compare/v0.1.0...v0.1.1
+[0.1.0]: https://gitlab.com/underworf/arckode-ui/-/tags/v0.1.0

package/CLAUDE.md.example

@@ -0,0 +1,123 @@
+# CLAUDE.md — proyecto que usa Arckode UI
+
+> Copiá este archivo a la raíz de tu proyecto (renómbralo a `CLAUDE.md`).
+> Claude Code / OpenCode lo cargan automáticamente cuando trabajan en el proyecto.
+
+## Skill obligatoria — leer ANTES de escribir código
+
+Arckode UI distribuye un SKILL con PROTOCOLO de 4 pasos y 16 REGLAS INMUTABLES.
+**Antes de crear/modificar cualquier `.ark` file, leer:**
+
+```
+./node_modules/arckode-ui/skills/SKILL.md
+```
+
+Sub-skills específicos por área:
+
+| Contexto | Sub-skill |
+|----------|-----------|
+| Escribir un `.ark`, patrones de UI (modal, form, lista) | `./node_modules/arckode-ui/skills/components/SKILL.md` |
+| Signals, computed, watch, comunicación padre↔hijo | `./node_modules/arckode-ui/skills/runtime/SKILL.md` |
+| Agregar regla nueva al analyzer | `./node_modules/arckode-ui/skills/analyzer/SKILL.md` |
+| CLI `ark` y generators | `./node_modules/arckode-ui/skills/cli/SKILL.md` |
+| Tests con vitest + happy-dom | `./node_modules/arckode-ui/skills/testing/SKILL.md` |
+| Compiler interno (avanzado) | `./node_modules/arckode-ui/skills/compiler/SKILL.md` |
+
+## Las 16 REGLAS INMUTABLES — referencia rápida
+
+| # | Regla | Detecta |
+|---|-------|---------|
+| 1 | Toda prop DEBE tener `type` (clase nativa) | `PROP_MISSING_TYPE` |
+| 2 | `emits` siempre kebab-case | `EMIT_CAMELCASE` |
+| 3 | `setup()` retorna SOLO `state`, `computed`, `actions` | `SETUP_UNKNOWN_RETURN_KEY` |
+| 4 | Handlers SIEMPRE `actions.xxx` | `HANDLER_NOT_IN_ACTIONS` |
+| 5 | `v-for` colección siempre namespaced | `VFOR_NOT_NAMESPACED` |
+| 6 | `v-if` con acceso namespaced (con `.`) | `VIF_NOT_NAMESPACED` |
+| 7 | NO existe `v-model` — input controlado explícito | — |
+| 8 | NO existe `ref()` ni `reactive()` — solo `signal()` | `REF_REACTIVE_USAGE` |
+| 9 | NO existe `provide`/`inject` — usar `defineStore` | `PROVIDE_INJECT_USAGE` |
+| 10 | `fetch()` PROHIBIDO en componente — usar `createService` | `DIRECT_FETCH_IN_COMPONENT` |
+| 11 | NO lógica en directivas (`++`, ternarios) | `LOGIC_IN_TEMPLATE` |
+| 12 | Actions como `function`, no arrow | `ARROW_FUNCTION_ACTION` |
+| 13 | Componentes hijos PascalCase + import explícito | — |
+| 14 | `mount(component, selector)` toma string | — |
+| 15 | Imports SOLO de `'arckode-ui'` o `'arckode-ui/vite'` | — |
+| 16 | Orden recomendado del `setup()` | — (convención) |
+
+Detalle completo y ejemplos en `./node_modules/arckode-ui/skills/SKILL.md`.
+
+## PROTOCOLO antes de codear
+
+```
+PASO 1 — IDENTIFICAR ALCANCE
+  ¿1 componente nuevo? ¿modificar existente? ¿estado global? ¿servicio HTTP?
+
+PASO 2 — VERIFICAR REGLAS (las 16 de arriba)
+
+PASO 3 — GENERAR
+  Si es componente nuevo: copiar PLANTILLA CANÓNICA del SKILL §5
+
+PASO 4 — VERIFICAR (NO asumir que funciona)
+  npx ark analyze    → 0 errors
+  Probar en navegador
+```
+
+## Comandos del proyecto
+
+```bash
+# Generar archivos con plantillas válidas garantizadas
+npx ark generate component <PascalCase>
+npx ark generate page <name>
+npx ark generate store <camelCase>
+npx ark generate service <PascalCase>
+npx ark generate layout <name>
+
+# Análisis
+npx ark analyze              # 0 errors antes de declarar listo
+npx ark routes               # listar rutas del file-system router
+
+# Dev / build
+bun dev
+bun build
+```
+
+## Anti-patterns más comunes (cada uno viola una regla)
+
+```typescript
+// ❌ REGLA #4
+@click="handleClick"          → @click="actions.handleClick"
+
+// ❌ REGLA #5
+v-for="item in items"         → v-for="item in state.items.value"
+
+// ❌ REGLA #7
+<input v-model="state.name"/> → :value + @input explícito
+
+// ❌ REGLA #8
+const x = ref(0)              → signal(0)
+
+// ❌ REGLA #11
+@click="state.count.value++"  → @click="actions.increment"
+:class="x.value ? 'a' : 'b'"  → mover a computed
+```
+
+## Cuando el analyzer reporta un error
+
+Cada violation incluye campo `Fix:` con sugerencia concreta. **Leerlo y aplicarlo literal:**
+
+```
+[arckode-ui] UserCard.ark:5
+  HANDLER_NOT_IN_ACTIONS: El handler "handleClick" no está namespaced.
+  > 5 | <button @click="handleClick">
+  Fix: Reemplazar "handleClick" por "actions.handleClick" y asegurarse de
+       que la función esté declarada en setup() y exportada en el return.actions.
+```
+
+## Benchmark de predictabilidad
+
+Test ciego (10 prompts × 2 variantes con Claude Sonnet):
+- **Sin SKILL:** 30% outputs válidos
+- **Con SKILL:** 100% outputs válidos
+
+Por eso vale la pena cargar el SKILL antes de generar código.
+Detalle en https://gitlab.com/underworf/arckode-ui/-/blob/main/BENCHMARK.md

package/README.md

@@ -1,10 +1,31 @@
 # Arckode UI
 
-Framework frontend con archivos `.ark` (Single File Components), reactividad por signals, compiler propio (Vite plugin), router file-system y analyzer estático.
+Framework frontend con archivos `.ark` (Single File Components), reactividad por signals, compiler propio (Vite plugin), router file-system y analyzer estático con sugerencias concretas de fix.
 
 > **Diseñado para máxima predictibilidad de output de IA.** Hay un solo camino correcto para cada problema. Para cada violation detectada, el analyzer sugiere el fix concreto.
 
-**Versión:** 0.1.0 — desarrollo activo
+**Predictabilidad medida (benchmark ciego con Claude Sonnet, 10 prompts):**
+**Sin SKILL: 30% outputs válidos · Con SKILL: 100%.** Ver [BENCHMARK.md](./BENCHMARK.md).
+
+**Versión:** 0.2.1 — desarrollo activo
+
+---
+
+## Activar el SKILL para tu IA (Claude/OpenCode)
+
+Después de instalar el paquete, copiá el `CLAUDE.md.example` a la raíz de tu proyecto:
+
+```bash
+cp node_modules/arckode-ui/CLAUDE.md.example ./CLAUDE.md
+```
+
+Eso hace que cualquier IA (Claude Code, OpenCode, Cursor) cargue automáticamente:
+- El PROTOCOLO de 4 pasos antes de codear
+- Las 16 reglas inmutables que el analyzer enforza
+- Las plantillas canónicas
+- Los 6 sub-skills temáticos (runtime, compiler, analyzer, cli, components, testing)
+
+Sin este archivo, la IA improvisa. Con este archivo, **9 de cada 10 outputs pasan el analyzer al primer intento**.
 
 ---
 

package/dist/cli/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ark — Arckode UI CLI
+ *
+ * NOTA: el shebang `#!/usr/bin/env node` se inyecta vía vite.config.ts banner
+ * solo en el output dist/cli.js. No ponerlo acá — esbuild lo rechaza como JS inválido.
+ *
+ * Usage:
+ *   ark new <nombre>
+ *   ark generate <tipo> <nombre>    (alias: ark g)
+ *   ark analyze [--json]
+ *   ark routes
+ *   ark dev [--port 3000] [--host]
+ *   ark build [--mode production|staging]
+ */
+export declare function main(argv?: string[]): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgJH,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,IAAI,CAwCjE"}

package/dist/compiler/analyzer.d.ts

@@ -0,0 +1,11 @@
+export interface Violation {
+    code: string;
+    severity: 'error' | 'warning';
+    line: number;
+    message: string;
+    /** Sugerencia concreta de cómo arreglar la violación. Solo presente cuando el fix es determinístico. */
+    fix?: string;
+}
+export declare function analyze(source: string, _filePath: string): Violation[];
+export declare function formatViolation(v: Violation, filePath: string, source: string): string;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/compiler/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/compiler/analyzer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,wGAAwG;IACxG,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAgoBD,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAsDtE;AAMD,wBAAgB,eAAe,CAC7B,CAAC,EAAE,SAAS,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAcR"}

package/dist/compiler/parser.d.ts

@@ -0,0 +1,21 @@
+export interface ArkSections {
+    template: {
+        content: string;
+        start: number;
+    };
+    script: {
+        content: string;
+        lang: string;
+    };
+    style?: {
+        content: string;
+        scoped: boolean;
+    };
+}
+export declare class ArkParseError extends Error {
+    readonly code: string;
+    readonly line: number;
+    constructor(code: string, message: string, line: number);
+}
+export declare function parseArkFile(source: string): ArkSections;
+//# sourceMappingURL=parser.d.ts.map

package/dist/compiler/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/compiler/parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;CAC7C;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAOxD;AAiCD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA4FxD"}

package/dist/compiler/template-compiler.d.ts

@@ -0,0 +1,20 @@
+export interface VNode {
+    tag: string | object | null;
+    props: Record<string, unknown>;
+    children: (VNode | string)[];
+}
+/**
+ * Compiles an HTML template string into a render function string.
+ *
+ * The returned string, when eval'd or imported as a module, produces a
+ * function with signature:
+ *
+ *   function render(props, state, computed, actions): VNode
+ *
+ * @param html - Raw HTML template (the content of <template>...</template>)
+ * @returns A self-contained JavaScript module string with:
+ *          - the `h()` helper
+ *          - the `render` function as default export
+ */
+export declare function compileTemplate(html: string): string;
+//# sourceMappingURL=template-compiler.d.ts.map

package/dist/compiler/template-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-compiler.d.ts","sourceRoot":"","sources":["../../src/compiler/template-compiler.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAA;CAC7B;AAiZD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BpD"}

package/dist/compiler/vite-plugin.d.ts

@@ -0,0 +1,14 @@
+import { Plugin } from 'vite';
+export interface ArkcodeUiOptions {
+    analyzer?: {
+        failOnWarnings?: boolean;
+        ignore?: string[];
+    };
+}
+/**
+ * Generates a deterministic 6-char alphanumeric scope ID from a file path.
+ * Used for scoped CSS: data-ark-{scopeId}
+ */
+export declare function generateScopeId(filePath: string): string;
+export declare function arkcodeUi(options?: ArkcodeUiOptions): Plugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/compiler/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../../src/compiler/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAA;AAUlD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;CACF;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWxD;AAqGD,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAuFhE"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { signal, computed, watch, effect } from './runtime/signals';
+export type { Signal, ComputedSignal, StopFn } from './runtime/signals';
+export { defineComponent, onMount, onUnmount, onUpdate } from './runtime/define-component';
+export type { ComponentOptions, Component, PropDefinition, PropsOptions, EmitsOptions, SetupContext, SetupReturn, } from './runtime/define-component';
+export { h } from './runtime/h';
+export type { VNode } from './runtime/h';
+export { mount, mountComponent } from './runtime/renderer';
+export { defineStore } from './store/define-store';
+export type { PersistOptions, StoreOptions, StoreInstance, UseStoreFn, } from './store/define-store';
+export { createService, ArkServiceError } from './services/create-service';
+export type { RequestOptions, ServiceContext, ServiceOptions, ServiceDefinition, ServiceInstance, } from './services/create-service';
+export { createRouter, navigate, useRoute, getCurrentPath, } from './router/router';
+export type { RouteDefinition, RouteRef, Router, RouteInfo, } from './router/router';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AACnE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAEvE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1F,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA;AAC/B,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC1E,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,2BAA2B,CAAA;AAIlC,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,eAAe,EACf,QAAQ,EACR,MAAM,EACN,SAAS,GACV,MAAM,iBAAiB,CAAA"}

package/dist/router/router.d.ts

@@ -0,0 +1,44 @@
+export interface RouteDefinition {
+    /** URL path, e.g. '/users/:id' */
+    path: string;
+    /** Relative file path, e.g. 'src/pages/users/[id].ark' */
+    filePath: string;
+    /** Dynamic param names extracted from the path, e.g. ['id'] */
+    params: string[];
+    /** true when the file is _layout.ark */
+    isLayout: boolean;
+    /** true when the file is _error.ark */
+    isError: boolean;
+    /** filePath of the _layout.ark that wraps this route, if any */
+    layoutPath?: string;
+}
+export type RouteRef = RouteDefinition;
+export interface Router {
+    match(path: string): {
+        route: RouteDefinition;
+        params: Record<string, string>;
+    } | null;
+    navigate(path: string): void;
+}
+export declare function getCurrentPath(): string;
+/**
+ * Scan a pages directory and return RouteDefinition[] for every .ark file found.
+ */
+export declare function scanPages(pagesDir: string): RouteDefinition[];
+export declare function createRouter(routes: RouteDefinition[]): Router;
+/**
+ * Typed navigate. Builds the URL from a RouteRef + param values.
+ */
+export declare function navigate(routeDef: RouteRef, params?: Record<string, string>): void;
+export interface RouteInfo {
+    params: Record<string, string>;
+    query: Record<string, string>;
+    path: string;
+}
+/**
+ * Returns current route info.
+ * params are extracted from the URL if a Router instance is available globally.
+ * query is parsed from window.location.search (or '' in Node.js).
+ */
+export declare function useRoute(): RouteInfo;
+//# sourceMappingURL=router.d.ts.map

package/dist/router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAA;IACjB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,QAAQ,GAAG,eAAe,CAAA;AAEtC,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAA;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AASD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAqHD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CA0D7D;AAgED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAyB9D;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CAcN;AAMD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,SAAS,CAiBpC"}

package/dist/runtime/define-component.d.ts

@@ -0,0 +1,43 @@
+import { Signal, ComputedSignal } from './signals';
+type PropType = StringConstructor | NumberConstructor | BooleanConstructor | ArrayConstructor | ObjectConstructor | FunctionConstructor;
+export interface PropDefinition {
+    type: PropType;
+    required?: boolean;
+    default?: unknown;
+}
+export type PropsOptions = Record<string, PropDefinition>;
+export type EmitsOptions = string[];
+type InferProps<P extends PropsOptions> = {
+    [K in keyof P]: P[K]['required'] extends true ? InferPropType<P[K]['type']> : InferPropType<P[K]['type']> | undefined;
+};
+type InferPropType<T extends PropType> = T extends StringConstructor ? string : T extends NumberConstructor ? number : T extends BooleanConstructor ? boolean : T extends ArrayConstructor ? unknown[] : T extends FunctionConstructor ? (...args: unknown[]) => unknown : unknown;
+export interface SetupContext<E extends EmitsOptions> {
+    emit: (event: E[number], payload?: unknown) => void;
+}
+export interface SetupReturn {
+    state?: Record<string, Signal<unknown>>;
+    computed?: Record<string, ComputedSignal<unknown>>;
+    actions?: Record<string, (...args: unknown[]) => unknown>;
+}
+export interface ComponentOptions<P extends PropsOptions = PropsOptions, E extends EmitsOptions = EmitsOptions> {
+    name: string;
+    props?: P;
+    emits?: E;
+    meta?: Record<string, unknown>;
+    setup(props: InferProps<P>, ctx: SetupContext<E>): SetupReturn;
+}
+export interface Component {
+    name: string;
+    props: PropsOptions;
+    emits: EmitsOptions;
+    meta: Record<string, unknown>;
+    setup: ComponentOptions['setup'];
+}
+export declare function defineComponent<P extends PropsOptions = PropsOptions, E extends EmitsOptions = EmitsOptions>(options: ComponentOptions<P, E>): Component;
+type LifecycleHook = () => void | Promise<void>;
+export declare function _setCurrentHookArrays(mount: LifecycleHook[], unmount: LifecycleHook[], update: LifecycleHook[]): void;
+export declare function onMount(fn: LifecycleHook): void;
+export declare function onUnmount(fn: LifecycleHook): void;
+export declare function onUpdate(fn: LifecycleHook): void;
+export {};
+//# sourceMappingURL=define-component.d.ts.map

package/dist/runtime/define-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-component.d.ts","sourceRoot":"","sources":["../../src/runtime/define-component.ts"],"names":[],"mappings":"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"}

package/dist/runtime/h.d.ts

@@ -0,0 +1,9 @@
+export interface VNode {
+    tag: string | object | null;
+    props: Record<string, unknown>;
+    children: (VNode | string)[];
+}
+type Child = VNode | string | number | boolean | null | undefined | Child[];
+export declare function h(tag: string | object | null, props: Record<string, unknown> | null, ...children: Child[]): VNode;
+export {};
+//# sourceMappingURL=h.d.ts.map

package/dist/runtime/h.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h.d.ts","sourceRoot":"","sources":["../../src/runtime/h.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAA;CAC7B;AAED,KAAK,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,EAAE,CAAA;AAE3E,wBAAgB,CAAC,CACf,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACrC,GAAG,QAAQ,EAAE,KAAK,EAAE,GACnB,KAAK,CAMP"}

package/dist/runtime/renderer.d.ts

@@ -0,0 +1,4 @@
+import { Component } from './define-component';
+export declare function mount(component: Component, selector: string): () => void;
+export declare function mountComponent(component: Component, props: Record<string, unknown>, container: HTMLElement, parentEmit: ((event: string, payload?: unknown) => void) | null): () => void;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/runtime/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/runtime/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AA6PnD,wBAAgB,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,IAAI,CAIxE;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,GAC9D,MAAM,IAAI,CA4DZ"}

package/dist/runtime/signals.d.ts

@@ -0,0 +1,16 @@
+export interface Signal<T> {
+    get value(): T;
+    set value(v: T);
+    readonly peek: T;
+}
+export interface ComputedSignal<T> {
+    readonly value: T;
+}
+export type StopFn = () => void;
+export declare function signal<T>(initialValue: T): Signal<T>;
+export declare function computed<T>(getter: () => T): ComputedSignal<T>;
+export declare function effect(fn: () => void): StopFn;
+export declare function watch<T>(source: Signal<T> | ComputedSignal<T>, callback: (newValue: T, oldValue: T) => void, options?: {
+    immediate?: boolean;
+}): StopFn;
+//# sourceMappingURL=signals.d.ts.map

package/dist/runtime/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/runtime/signals.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,IAAI,KAAK,IAAI,CAAC,CAAA;IACd,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAC;IACf,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,IAAI,CAAA;AAE/B,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAmBpD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CA4B9D;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,CAmB7C;AAED,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EACrC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI,EAC5C,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CA2BR"}

package/dist/services/create-service.d.ts

@@ -0,0 +1,29 @@
+export declare class ArkServiceError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown, message: string);
+}
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+export interface ServiceContext {
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body: unknown, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+export interface ServiceOptions {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export type ServiceDefinition = {
+    [key: string]: (this: ServiceContext, ...args: any[]) => Promise<unknown>;
+};
+export type ServiceInstance<T extends ServiceDefinition> = {
+    [K in keyof T]: T[K];
+};
+export declare function createService<T extends ServiceDefinition>(options: ServiceOptions, definition: T): ServiceInstance<T>;
+//# sourceMappingURL=create-service.d.ts.map

package/dist/services/create-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-service.d.ts","sourceRoot":"","sources":["../../src/services/create-service.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;gBADb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAC7B,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC1D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC1E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACzE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1E,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,iBAAiB,IAAI;KACxD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,CAAA;AAqJD,wBAAgB,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvD,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,CAAC,GACZ,eAAe,CAAC,CAAC,CAAC,CASpB"}

package/dist/store/define-store.d.ts

@@ -0,0 +1,22 @@
+import { Signal, ComputedSignal } from '../runtime/signals';
+export type { Signal, ComputedSignal };
+export interface PersistOptions {
+    storage: 'localStorage' | 'sessionStorage';
+    key: string;
+    pick?: string[];
+}
+export interface StoreOptions<S extends Record<string, Signal<unknown>>, A extends Record<string, (...args: unknown[]) => unknown>, G extends Record<string, ComputedSignal<unknown>> = Record<string, never>> {
+    state: S;
+    actions: A;
+    getters?: G;
+    persist?: PersistOptions;
+}
+export interface StoreInstance<S extends Record<string, Signal<unknown>>, A extends Record<string, (...args: unknown[]) => unknown>, G extends Record<string, ComputedSignal<unknown>>> {
+    state: S;
+    actions: A;
+    getters: G;
+}
+export type UseStoreFn<S extends Record<string, Signal<unknown>>, A extends Record<string, (...args: unknown[]) => unknown>, G extends Record<string, ComputedSignal<unknown>>> = () => StoreInstance<S, A, G>;
+export declare function defineStore<S extends Record<string, Signal<unknown>>, A extends Record<string, (...args: unknown[]) => unknown>, G extends Record<string, ComputedSignal<unknown>> = Record<string, never>>(id: string, options: StoreOptions<S, A, G>): UseStoreFn<S, A, G>;
+export declare function _clearRegistry(): void;
+//# sourceMappingURL=define-store.d.ts.map

package/dist/store/define-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-store.d.ts","sourceRoot":"","sources":["../../src/store/define-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEhE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;AAEtC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAA;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,YAAY,CAC3B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EACzC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEzE,KAAK,EAAE,CAAC,CAAA;IACR,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,CAAC,EAAE,CAAC,CAAA;IACX,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED,MAAM,WAAW,aAAa,CAC5B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EACzC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAEjD,KAAK,EAAE,CAAC,CAAA;IACR,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,EAAE,CAAC,CAAA;CACX;AAED,MAAM,MAAM,UAAU,CACpB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EACzC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,IAC/C,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAsFhC,wBAAgB,WAAW,CACzB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EACzC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzE,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAqCrB;AAGD,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arckode-ui",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "description": "Frontend framework con .ark SFCs, signals, file-system router y analyzer estático con sugerencias concretas de fix. Diseñado para máxima predictibilidad de output de IA.",
   "keywords": [
@@ -27,12 +27,12 @@
   },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./vite": {
-      "import": "./dist/vite.js",
-      "types": "./dist/vite.d.ts"
+      "types": "./dist/compiler/vite-plugin.d.ts",
+      "import": "./dist/vite.js"
     }
   },
   "main": "./dist/index.js",
@@ -44,7 +44,9 @@
     "dist",
     "skills",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CLAUDE.md.example",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "vite build && chmod +x dist/cli.js",
@@ -58,10 +60,12 @@
     "vite": ">=5.0.0"
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.98.0",
     "@types/bun": "latest",
     "happy-dom": "^20.9.0",
     "typescript": "^5.4.0",
     "vite": "^5.4.0",
+    "vite-plugin-dts": "^5.0.1",
     "vitest": "^2.0.0"
   }
 }

package/skills/SKILL.md

@@ -650,6 +650,55 @@ export const useUserStore = defineStore('user', {
 })
 ```
 
+### ⚠ Trap conocido del store — `useStore()` dentro de getters/actions
+
+El patrón `useUserStore()` dentro de getters/actions FUNCIONA porque cuando esos
+callbacks se ejecutan, el registry del store YA tiene la instancia registrada.
+Pero hay dos cosas a saber:
+
+1. **NO lo llames durante la DEFINICIÓN del objeto** — solo dentro del callback.
+   Si lo llamás afuera, el registry todavía no tiene la instancia y devuelve `undefined`
+   o tira error.
+
+   ```typescript
+   // ❌ MAL: useStore() en evaluación del valor del state
+   export const useStore = defineStore('x', {
+     state: {
+       current: useStore().getters.somethingElse,  // ← infinite loop / crash
+     },
+   })
+
+   // ✅ BIEN: useStore() solo dentro del callback (computed/function)
+   export const useStore = defineStore('x', {
+     state: { current: signal(null) },
+     getters: {
+       label: computed(() => useStore().state.current.value ?? 'anonymous'),
+     },
+   })
+   ```
+
+2. **Pattern alternativo más limpio**: declarar los signals fuera del defineStore
+   y referenciarlos directo. Evita el `useStore()` en absoluto:
+
+   ```typescript
+   // signals al top-level del módulo
+   const current = signal<UserDTO | null>(null)
+   const loading = signal(false)
+   const isLoggedIn = computed(() => current.value !== null)
+
+   export const useUserStore = defineStore('user', {
+     state: { current, loading },
+     getters: { isLoggedIn },
+     actions: {
+       async login(...) { loading.value = true; /* ... */ },
+       logout() { current.value = null },
+     },
+   })
+   ```
+
+   Esta forma es más TS-friendly (no requiere casts dentro de callbacks), más
+   testeable (los signals son inspeccionables sin invocar el store) y más legible.
+
 Uso en componente:
 ```typescript
 const userStore = useUserStore()