arckode-ui 0.2.1 → 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/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.1",
+  "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",
@@ -45,7 +45,8 @@
     "skills",
     "README.md",
     "LICENSE",
-    "CLAUDE.md.example"
+    "CLAUDE.md.example",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "vite build && chmod +x dist/cli.js",
@@ -64,6 +65,7 @@
     "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()