@meekojs/meeko 0.0.2 → 0.0.4

package/README.md

@@ -14,9 +14,11 @@ El proyecto está en etapa temprana. Ya funciona el recorrido completo de un con
 
 - [Arquitectura y contratos](docs/architecture.md)
 - [API y límites de compatibilidad](docs/api.md)
+- [Aplicaciones full-stack con Meeko](docs/framework.md)
 - [Plan de desarrollo y criterios de aceptación](docs/roadmap.md)
 - [Comparativa reproducible con Vue](docs/benchmarks.md)
 - [DevTools para depurar componentes](docs/devtools.md)
+- [Aplicación piloto SSR](examples/pilot/README.md)
 - [Publicación y verificaciones](docs/releasing.md)
 - [Historial de cambios](CHANGELOG.md)
 - [Guía para contribuir](CONTRIBUTING.md)
@@ -45,6 +47,37 @@ export default defineConfig({ plugins: [meeko()] });
 
 El paquete incluye TypeScript 7 y la CLI `meeko`. Puedes comprobar un componente con `pnpm exec meeko check ruta/Componente.meeko`. Vite es opcional si sólo usas el compilador y SSR.
 
+### Crear una aplicación SSR
+
+Con el paquete instalado, `meeko init` crea un proyecto independiente. El servidor renderiza el componente `.meeko` y transfiere props y señales para que el navegador hidrate el HTML existente.
+
+```powershell
+pnpm exec meeko init mi-app
+cd mi-app
+npm install
+npm run dev
+```
+
+Abre `http://127.0.0.1:4173`. `npm run check` genera los tipos del componente y ejecuta TypeScript 7. `npm run build` compila cliente y servidor; `npm start` sirve la versión compilada con SSR. La CLI no sobrescribe archivos de aplicación existentes.
+
+Desde `0.0.3`, si ya ejecutaste `pnpm add @meekojs/meeko` en una carpeta sin código, puedes inicializarla directamente con `pnpm exec meeko init .`. Se conservan el manifiesto, los lockfiles, el workspace y `node_modules`; la CLI rechaza archivos de aplicación o scripts que entrarían en conflicto. Después ejecuta `pnpm install` y `pnpm run dev`. Para actualizar desde `0.0.2`, usa `pnpm add @meekojs/meeko@0.0.3` antes de `init .`.
+
+### Crear una aplicación full-stack
+
+Meeko Engine permite usar componentes `.meeko` de forma independiente. Meeko Framework añade rutas por archivos, layouts, SSR, estado por petición, API, RPC, sesiones y WebSocket con el mismo compilador y runtime. **La versión `0.0.4` que incluye este framework está preparada, pero aún no se ha publicado en npm.** Una vez publicada e instalada, crea una aplicación con:
+
+```powershell
+pnpm exec meeko init-framework my-app
+cd my-app
+npm install
+npm run dev
+npm run check
+npm run build
+npm start
+```
+
+`check` genera contratos y comprueba tipos; `build` produce cliente, servidor y prerender. `start` sirve SSR de producción con Node 24 y requiere configurar sesiones persistentes. La [guía del framework](docs/framework.md) explica configuración, autoimports, rutas, despliegue y seguridad.
+
 ## Estructura
 
 | Ruta | Responsabilidad |
@@ -73,11 +106,12 @@ El paquete incluye TypeScript 7 y la CLI `meeko`. Puedes comprobar un componente
 pnpm install
 pnpm run verify
 pnpm run e2e
+pnpm run pilot:e2e
 pnpm run package:smoke
 pnpm run example:serve
 ```
 
-`e2e` usa Chrome instalado localmente; `MEEKO_CHROME_PATH` permite indicar otro ejecutable compatible. Prueba Vite en desarrollo y producción, además de una página SSR con navegación. `package:smoke` instala el tarball en un proyecto temporal externo y prueba CLI, SSR, tipos y Vite. La última orden sirve el ejemplo en `http://127.0.0.1:4173`. El servidor envía HTML y las props iniciales como JSON escapado; el navegador hidrata el botón sin reemplazarlo.
+`e2e` usa Chrome instalado localmente; `MEEKO_CHROME_PATH` permite indicar otro ejecutable compatible. Prueba Vite en desarrollo y producción, además de una página SSR con navegación. `pilot:e2e` prueba la aplicación piloto en Chromium, Firefox y WebKit instalados por Playwright, tanto en desarrollo como en producción. `package:smoke` instala el tarball en un proyecto temporal externo y prueba CLI, SSR, tipos, Vite y `meeko init`. La última orden sirve el contador en `http://127.0.0.1:4173`.
 
 Para probar la compilación automática con Vite:
 
@@ -108,13 +142,17 @@ node dist/cli.js types ruta/Componente.meeko
 
 La aplicación debe pasar **las mismas props** al render y a `hydrate`. `renderWithState(props)` entrega HTML y señales editables serializables; el ejemplo SSR transfiere ambos junto con las props mediante `serializeJson` y llama `hydrate(root, props, state)`. Meeko comprueba que el texto existente coincida durante la hidratación y devuelve una función que desconecta eventos y observadores. El HTML dinámico se escapa en el servidor.
 
+## Aplicación piloto
+
+[`examples/pilot`](examples/pilot/README.md) reúne SSR, hidratación, componentes anidados, listas, formularios, rutas y una API asíncrona. Se ejecuta con `pnpm run pilot:dev`; `pnpm run pilot:build` y `pnpm run pilot:serve` prueban los artefactos de producción sin middleware de Vite. La prueba `pnpm run pilot:e2e` recorre ambos modos en Chromium, Firefox y WebKit. WebKit de Playwright no equivale a una prueba en Safari real.
+
 ## Sintaxis inicial
 
 Un archivo tiene `<script lang="ts">`, `<template>` y un `<style>` opcional; `scoped` limita las reglas CSS al componente. `defineProps<Props>()` declara las props. La plantilla acepta expresiones de texto `{expression}`, eventos `on:click="handler"` y atributos dinámicos `bind:title="expression"`. Los atributos booleanos, como `bind:disabled`, se agregan o eliminan según el valor.
 
 `if:when="expression"` muestra u oculta un elemento. Una lista usa `each:of="items"`, `each:as="item"` y `each:key="item.id"`; `each:index="position"` permite nombrar el índice, que se llama `index` por defecto. Las claves deben ser cadenas o números finitos y no pueden repetirse. Meeko conserva los nodos de las claves existentes al reordenar la lista. [Regions.meeko](examples/regions/Regions.meeko) muestra condiciones, listas anidadas, eventos y atributos dinámicos.
 
-Un componente importado en el script se inserta con `<component is="Child" bind:label="expression"></component>`. Las props se comprueban con TypeScript y cada hijo se hidrata dentro de un rango de comentarios, sin un elemento envolvente. El cierre explícito es obligatorio; la sintaxis autocerrada de HTML no se admite para `<component>`. [Parent.meeko](examples/nested/Parent.meeko) muestra hijos y nietos dentro de condiciones y listas.
+Un componente importado en el script se inserta con `<component is="Child" bind:label="expression"></component>`. Las props se comprueban con TypeScript y cada hijo se hidrata dentro de un rango de comentarios, sin un elemento envolvente. `is` también acepta un componente recibido como prop tipada `Component<Props>`; así se puede insertar contenido reutilizable y cambiarlo reactivamente. La comunicación hacia el padre usa callbacks tipados en las props, y `createContext<T>()` permite compartir valores con descendientes. El cierre explícito es obligatorio; la sintaxis autocerrada de HTML no se admite para `<component>`. [Parent.meeko](examples/nested/Parent.meeko) muestra hijos y nietos dentro de condiciones y listas.
 
 Los errores de sintaxis de script, plantilla y CSS, así como los errores de tipos en declaraciones y expresiones, tienen ubicación en `.meeko`. Los errores atribuibles sólo al código auxiliar generado se identifican explícitamente.
 

package/dist/autoimports-ts.d.ts

@@ -0,0 +1,26 @@
+import type { AutoImport, ImportScope } from "./autoimports.js";
+export type TypeScriptScope = ImportScope;
+/** Selects the application scope of a source file without executing it. */
+export declare function typeScriptScope(root: string, filename: string): TypeScriptScope | undefined;
+/** Produces global editor declarations for isolated app, server and shared TS projects. */
+export declare function generateAutoImportTypes(projectRoot: string): Promise<{
+    client: string;
+    server: string;
+    shared: string;
+}>;
+/** Vite can call this for app/shared/server TypeScript before its normal TS transform. */
+export declare function transformTypeScriptAutoImports(source: string, filename: string, root: string, registry: readonly AutoImport[]): string | undefined;
+/** Maps the unchanged source body after imports inserted at the start of a TS module. */
+export declare function typeScriptAutoImportMap(source: string, transformed: string, filename: string): {
+    version: 3;
+    sources: string[];
+    sourcesContent: string[];
+    names: string[];
+    mappings: string;
+};
+/** Convenience entrypoint for CLI generators. */
+export declare function generateTypeScriptAutoImports(projectRoot: string): Promise<{
+    client: string;
+    server: string;
+    shared: string;
+}>;

package/dist/autoimports-ts.js

@@ -0,0 +1,127 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, relative, resolve, sep } from "node:path";
+import ts from "@typescript/typescript6";
+import { applyAutoImports, discoverAutoImports } from "./autoimports.js";
+function within(root, filename) {
+    const path = relative(resolve(root), resolve(filename));
+    return path === ".." || path.startsWith(`..${sep}`) || path.startsWith("/") ? undefined : path.replaceAll("\\", "/");
+}
+/** Selects the application scope of a source file without executing it. */
+export function typeScriptScope(root, filename) {
+    const path = within(root, filename);
+    if (!path || !/\.[cm]?tsx?$/.test(path) || /\.(?:test|spec|d)\.[cm]?tsx?$/.test(path))
+        return undefined;
+    if (/\.shared\.[cm]?tsx?$/.test(path))
+        return "shared";
+    if (/\.server\.[cm]?tsx?$/.test(path))
+        return "server";
+    if (/\.route\.[cm]?tsx?$/.test(path) && /(?:^|\/)app\/pages\//.test(path))
+        return "server";
+    if (/\.client\.[cm]?tsx?$/.test(path))
+        return "client";
+    if (path.startsWith("server/"))
+        return "server";
+    if (path.startsWith("app/"))
+        return "client";
+    if (path.startsWith("shared/"))
+        return "shared";
+    return undefined;
+}
+function publicSpecifier(outputDirectory, entry) {
+    if (entry.specifier)
+        return entry.specifier;
+    const path = relative(outputDirectory, entry.file).replaceAll("\\", "/");
+    const prefixed = path.startsWith(".") ? path : `./${path}`;
+    return entry.component ? prefixed : prefixed.replace(/\.[cm]?ts$/, (extension) => extension === ".mts" ? ".mjs" : extension === ".cts" ? ".cjs" : ".js");
+}
+function scopeEntries(registry, scope) {
+    return registry.filter((entry) => entry.scope === "shared" || (scope !== "shared" && entry.scope === scope));
+}
+function assertNoCollisions(entries, scope) {
+    const symbols = new Map();
+    for (const entry of entries) {
+        const previous = symbols.get(entry.name);
+        if (previous)
+            throw new Error(`Ambiguous autoimport ${entry.name} in ${scope} scope: ${previous.file}, ${entry.file}`);
+        symbols.set(entry.name, entry);
+    }
+}
+async function typeDeclaration(entry, specifier) {
+    if (entry.specifier)
+        return `  type ${entry.name} = import(${specifier}).${entry.imported};`;
+    const source = await readFile(entry.file, "utf8");
+    const file = ts.createSourceFile(entry.file, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const declaration = file.statements.find((statement) => (ts.isTypeAliasDeclaration(statement) || ts.isInterfaceDeclaration(statement)) && statement.name.text === entry.imported);
+    if (!declaration || (!ts.isTypeAliasDeclaration(declaration) && !ts.isInterfaceDeclaration(declaration)) || !declaration.typeParameters?.length) {
+        return `  type ${entry.name} = import(${specifier}).${entry.imported};`;
+    }
+    const parameters = `<${declaration.typeParameters.map((parameter) => parameter.getText(file)).join(", ")}>`;
+    const arguments_ = `<${declaration.typeParameters.map((parameter) => parameter.name.text).join(", ")}>`;
+    return `  type ${entry.name}${parameters} = import(${specifier}).${entry.imported}${arguments_};`;
+}
+/** Produces global editor declarations for isolated app, server and shared TS projects. */
+export async function generateAutoImportTypes(projectRoot) {
+    const root = resolve(projectRoot);
+    const outputDirectory = join(root, ".meeko", "types", "autoimports");
+    const registry = await discoverAutoImports(root);
+    await mkdir(outputDirectory, { recursive: true });
+    const outputs = {};
+    for (const scope of ["client", "server", "shared"]) {
+        const entries = scopeEntries(registry, scope);
+        assertNoCollisions(entries, scope);
+        const declarations = await Promise.all(entries.sort((a, b) => a.name.localeCompare(b.name)).map(async (entry) => {
+            const specifier = JSON.stringify(publicSpecifier(outputDirectory, entry));
+            if (entry.typeOnly)
+                return typeDeclaration(entry, specifier);
+            const value = entry.component ? `typeof import(${specifier})` : `typeof import(${specifier})[${JSON.stringify(entry.imported)}]`;
+            return `  const ${entry.name}: ${value};`;
+        }));
+        const path = join(outputDirectory, `${scope}.d.ts`);
+        const source = ["// Generated by Meeko. Scope-specific editor declarations.", "export {};", "declare global {", ...declarations, "}", ""].join("\n");
+        let previous;
+        try {
+            previous = await readFile(path, "utf8");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        if (previous !== source)
+            await writeFile(path, source, "utf8");
+        outputs[scope] = path;
+    }
+    return outputs;
+}
+/** Vite can call this for app/shared/server TypeScript before its normal TS transform. */
+export function transformTypeScriptAutoImports(source, filename, root, registry) {
+    const scope = typeScriptScope(root, filename);
+    if (!scope)
+        return undefined;
+    if (scope === "shared") {
+        // A shared module must resolve identically from both client and server views.
+        const client = applyAutoImports(source, filename, registry, "client");
+        const server = applyAutoImports(source, filename, registry, "server");
+        if (client !== server)
+            throw new Error(`Shared module ${filename} references an app or server autoimport`);
+        return client === source ? undefined : client;
+    }
+    const transformed = applyAutoImports(source, filename, registry, scope);
+    return transformed === source ? undefined : transformed;
+}
+/** Maps the unchanged source body after imports inserted at the start of a TS module. */
+export function typeScriptAutoImportMap(source, transformed, filename) {
+    if (!transformed.endsWith(source))
+        throw new TypeError("Autoimport transform must preserve the original TypeScript body");
+    const prefix = transformed.slice(0, -source.length);
+    const insertedLines = (prefix.match(/\n/g) ?? []).length;
+    const sourceLines = source.split(/\r\n|\r|\n/).length;
+    return {
+        version: 3, sources: [filename], sourcesContent: [source], names: [],
+        mappings: `${";".repeat(insertedLines)}AAAA${";AACA".repeat(Math.max(0, sourceLines - 1))}`,
+    };
+}
+/** Convenience entrypoint for CLI generators. */
+export async function generateTypeScriptAutoImports(projectRoot) {
+    return generateAutoImportTypes(projectRoot);
+}
+//# sourceMappingURL=autoimports-ts.js.map

package/dist/autoimports-ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoimports-ts.js","sourceRoot":"","sources":["../src/autoimports-ts.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, resolve, sep } from \"node:path\";\nimport ts from \"@typescript/typescript6\";\nimport { applyAutoImports, discoverAutoImports } from \"./autoimports.js\";\nimport type { AutoImport, ImportScope } from \"./autoimports.js\";\n\nexport type TypeScriptScope = ImportScope;\n\nfunction within(root: string, filename: string): string | undefined {\n  const path = relative(resolve(root), resolve(filename));\n  return path === \"..\" || path.startsWith(`..${sep}`) || path.startsWith(\"/\") ? undefined : path.replaceAll(\"\\\\\", \"/\");\n}\n\n/** Selects the application scope of a source file without executing it. */\nexport function typeScriptScope(root: string, filename: string): TypeScriptScope | undefined {\n  const path = within(root, filename);\n  if (!path || !/\\.[cm]?tsx?$/.test(path) || /\\.(?:test|spec|d)\\.[cm]?tsx?$/.test(path)) return undefined;\n  if (/\\.shared\\.[cm]?tsx?$/.test(path)) return \"shared\";\n  if (/\\.server\\.[cm]?tsx?$/.test(path)) return \"server\";\n  if (/\\.route\\.[cm]?tsx?$/.test(path) && /(?:^|\\/)app\\/pages\\//.test(path)) return \"server\";\n  if (/\\.client\\.[cm]?tsx?$/.test(path)) return \"client\";\n  if (path.startsWith(\"server/\")) return \"server\";\n  if (path.startsWith(\"app/\")) return \"client\";\n  if (path.startsWith(\"shared/\")) return \"shared\";\n  return undefined;\n}\n\nfunction publicSpecifier(outputDirectory: string, entry: AutoImport): string {\n  if (entry.specifier) return entry.specifier;\n  const path = relative(outputDirectory, entry.file).replaceAll(\"\\\\\", \"/\");\n  const prefixed = path.startsWith(\".\") ? path : `./${path}`;\n  return entry.component ? prefixed : prefixed.replace(/\\.[cm]?ts$/, (extension) => extension === \".mts\" ? \".mjs\" : extension === \".cts\" ? \".cjs\" : \".js\");\n}\n\nfunction scopeEntries(registry: readonly AutoImport[], scope: TypeScriptScope): AutoImport[] {\n  return registry.filter((entry) => entry.scope === \"shared\" || (scope !== \"shared\" && entry.scope === scope));\n}\n\nfunction assertNoCollisions(entries: readonly AutoImport[], scope: TypeScriptScope): void {\n  const symbols = new Map<string, AutoImport>();\n  for (const entry of entries) {\n    const previous = symbols.get(entry.name);\n    if (previous) throw new Error(`Ambiguous autoimport ${entry.name} in ${scope} scope: ${previous.file}, ${entry.file}`);\n    symbols.set(entry.name, entry);\n  }\n}\n\nasync function typeDeclaration(entry: AutoImport, specifier: string): Promise<string> {\n  if (entry.specifier) return `  type ${entry.name} = import(${specifier}).${entry.imported};`;\n  const source = await readFile(entry.file, \"utf8\");\n  const file = ts.createSourceFile(entry.file, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);\n  const declaration = file.statements.find((statement) =>\n    (ts.isTypeAliasDeclaration(statement) || ts.isInterfaceDeclaration(statement)) && statement.name.text === entry.imported);\n  if (!declaration || (!ts.isTypeAliasDeclaration(declaration) && !ts.isInterfaceDeclaration(declaration)) || !declaration.typeParameters?.length) {\n    return `  type ${entry.name} = import(${specifier}).${entry.imported};`;\n  }\n  const parameters = `<${declaration.typeParameters.map((parameter) => parameter.getText(file)).join(\", \")}>`;\n  const arguments_ = `<${declaration.typeParameters.map((parameter) => parameter.name.text).join(\", \")}>`;\n  return `  type ${entry.name}${parameters} = import(${specifier}).${entry.imported}${arguments_};`;\n}\n\n/** Produces global editor declarations for isolated app, server and shared TS projects. */\nexport async function generateAutoImportTypes(projectRoot: string): Promise<{ client: string; server: string; shared: string }> {\n  const root = resolve(projectRoot);\n  const outputDirectory = join(root, \".meeko\", \"types\", \"autoimports\");\n  const registry = await discoverAutoImports(root);\n  await mkdir(outputDirectory, { recursive: true });\n  const outputs = {} as { client: string; server: string; shared: string };\n  for (const scope of [\"client\", \"server\", \"shared\"] as const) {\n    const entries = scopeEntries(registry, scope);\n    assertNoCollisions(entries, scope);\n    const declarations = await Promise.all(entries.sort((a, b) => a.name.localeCompare(b.name)).map(async (entry) => {\n      const specifier = JSON.stringify(publicSpecifier(outputDirectory, entry));\n      if (entry.typeOnly) return typeDeclaration(entry, specifier);\n      const value = entry.component ? `typeof import(${specifier})` : `typeof import(${specifier})[${JSON.stringify(entry.imported)}]`;\n      return `  const ${entry.name}: ${value};`;\n    }));\n    const path = join(outputDirectory, `${scope}.d.ts`);\n    const source = [\"// Generated by Meeko. Scope-specific editor declarations.\", \"export {};\", \"declare global {\", ...declarations, \"}\", \"\"].join(\"\\n\");\n    let previous: string | undefined;\n    try { previous = await readFile(path, \"utf8\"); }\n    catch (error) { if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error; }\n    if (previous !== source) await writeFile(path, source, \"utf8\");\n    outputs[scope] = path;\n  }\n  return outputs;\n}\n\n/** Vite can call this for app/shared/server TypeScript before its normal TS transform. */\nexport function transformTypeScriptAutoImports(source: string, filename: string, root: string, registry: readonly AutoImport[]): string | undefined {\n  const scope = typeScriptScope(root, filename);\n  if (!scope) return undefined;\n  if (scope === \"shared\") {\n    // A shared module must resolve identically from both client and server views.\n    const client = applyAutoImports(source, filename, registry, \"client\");\n    const server = applyAutoImports(source, filename, registry, \"server\");\n    if (client !== server) throw new Error(`Shared module ${filename} references an app or server autoimport`);\n    return client === source ? undefined : client;\n  }\n  const transformed = applyAutoImports(source, filename, registry, scope);\n  return transformed === source ? undefined : transformed;\n}\n\n/** Maps the unchanged source body after imports inserted at the start of a TS module. */\nexport function typeScriptAutoImportMap(source: string, transformed: string, filename: string): {\n  version: 3; sources: string[]; sourcesContent: string[]; names: string[]; mappings: string;\n} {\n  if (!transformed.endsWith(source)) throw new TypeError(\"Autoimport transform must preserve the original TypeScript body\");\n  const prefix = transformed.slice(0, -source.length);\n  const insertedLines = (prefix.match(/\\n/g) ?? []).length;\n  const sourceLines = source.split(/\\r\\n|\\r|\\n/).length;\n  return {\n    version: 3, sources: [filename], sourcesContent: [source], names: [],\n    mappings: `${\";\".repeat(insertedLines)}AAAA${\";AACA\".repeat(Math.max(0, sourceLines - 1))}`,\n  };\n}\n\n/** Convenience entrypoint for CLI generators. */\nexport async function generateTypeScriptAutoImports(projectRoot: string): Promise<{ client: string; server: string; shared: string }> {\n  return generateAutoImportTypes(projectRoot);\n}\n"]}

package/dist/autoimports.d.ts

@@ -0,0 +1,21 @@
+import type { CompileOptions, CompileResult } from "./compiler.js";
+export type ImportScope = "client" | "server" | "shared";
+export interface AutoImport {
+    name: string;
+    imported: string;
+    file: string;
+    scope: ImportScope;
+    typeOnly: boolean;
+    component: boolean;
+    specifier?: string;
+}
+/** Construye el registro a partir de exports sintácticos, sin ejecutar módulos de la aplicación. */
+export declare function discoverAutoImports(root: string): Promise<AutoImport[]>;
+/** Same static registry used by the synchronous VS Code Language Service. */
+export declare function discoverAutoImportsSync(root: string): AutoImport[];
+/** Añade imports ESM para referencias libres del módulo generado. */
+export declare function applyAutoImports(code: string, filename: string, registry: readonly AutoImport[], target: "client" | "server"): string;
+/** Transforma un SFC usando exactamente el mismo compilador que el plugin Vite. */
+export declare function transformAutoImports(source: string, filename: string, code: string, registry: readonly AutoImport[], target: "client" | "server"): string;
+/** Compile result shared by Vite, CLI checks and declaration generation. */
+export declare function compileWithAutoImports(source: string, filename: string, options?: CompileOptions, target?: "client" | "server"): Promise<CompileResult>;

package/dist/autoimports.js

@@ -0,0 +1,285 @@
+import { readdir, readFile } from "node:fs/promises";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { extname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import ts from "@typescript/typescript6";
+import { compile } from "./compiler.js";
+import { projectRoot } from "./compiler/project-root.js";
+import { parseSfc } from "./compiler/sfc.js";
+import { loadMeekoConfig, readMeekoConfigSync, resolveConfigSources } from "./framework/config.js";
+const directories = [
+    "app/components", "app/composables", "app/utils", "app/stores",
+    "shared/types", "shared/schemas", "shared/utils", "shared/constants", "shared/enums",
+    "server/utils",
+];
+function scopeOf(file) {
+    if (/\.shared\.[cm]?tsx?$/.test(file))
+        return "shared";
+    if (/\.server\.[cm]?tsx?$/.test(file))
+        return "server";
+    if (/\.client\.[cm]?tsx?$/.test(file))
+        return "client";
+    if (file.includes(`${sep}server${sep}`))
+        return "server";
+    if (file.includes(`${sep}app${sep}`))
+        return "client";
+    return "shared";
+}
+async function filesIn(path) {
+    const entries = await readdir(path, { withFileTypes: true }).catch(() => []);
+    const files = [];
+    for (const entry of entries) {
+        const filename = join(path, entry.name);
+        if (entry.isDirectory())
+            files.push(...await filesIn(filename));
+        else if (/\.(?:meeko|[cm]?ts)$/.test(entry.name) && !/\.(?:test|spec|d)\.[cm]?ts$/.test(entry.name))
+            files.push(filename);
+    }
+    return files;
+}
+function filesInSync(path) {
+    let entries;
+    try {
+        entries = readdirSync(path, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const files = [];
+    for (const entry of entries) {
+        const filename = join(path, entry.name);
+        if (entry.isDirectory())
+            files.push(...filesInSync(filename));
+        else if (/\.(?:meeko|[cm]?ts)$/.test(entry.name) && !/\.(?:test|spec|d)\.[cm]?ts$/.test(entry.name))
+            files.push(filename);
+    }
+    return files;
+}
+function builtins(root) {
+    const entries = [
+        ...["signal", "computed", "effect", "batch", "onCleanup", "provide", "inject", "createContext"].map((name) => ({ name, imported: name, file: "@meekojs/meeko", specifier: "@meekojs/meeko", scope: "shared", typeOnly: false, component: false })),
+        ...["useState", "href"].map((name) => ({ name, imported: name, file: "@meekojs/meeko/framework", specifier: "@meekojs/meeko/framework", scope: "shared", typeOnly: false, component: false })),
+    ];
+    for (const scope of ["client", "server"]) {
+        const file = join(root, ".meeko", "generated", `clients.${scope}.ts`);
+        if (!existsSync(file))
+            continue;
+        for (const name of ["api", "rpc", "socket", "useSocket"])
+            entries.push({ name, imported: name, file, scope, typeOnly: false, component: false });
+    }
+    if (!entries.some((entry) => entry.name === "useSocket")) {
+        entries.push({ name: "useSocket", imported: "useSocket", file: "@meekojs/meeko/framework", specifier: "@meekojs/meeko/framework", scope: "shared", typeOnly: false, component: false });
+    }
+    return entries;
+}
+function addFileImports(result, root, directory, file, source) {
+    const scope = scopeOf(file);
+    if (extname(file) === ".meeko") {
+        if (directory !== "app/components")
+            return;
+        const path = relative(join(root, directory), file).replace(/\.meeko$/, "");
+        const name = path.split(/[\\/]/).map((part) => part.replace(/(^|[-_])(\w)/g, (_, _dash, letter) => letter.toUpperCase())).join("");
+        result.push({ name, imported: "*", file, scope, typeOnly: false, component: true });
+        return;
+    }
+    const ast = ts.createSourceFile(file, source ?? "", ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    for (const statement of ast.statements) {
+        const exported = ts.canHaveModifiers(statement) && ts.getModifiers(statement)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword);
+        if (exported && (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement) || ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement) || ts.isEnumDeclaration(statement)) && statement.name) {
+            result.push({ name: statement.name.text, imported: statement.name.text, file, scope, typeOnly: ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement), component: false });
+        }
+        if (exported && ts.isVariableStatement(statement)) {
+            for (const declaration of statement.declarationList.declarations)
+                if (ts.isIdentifier(declaration.name)) {
+                    result.push({ name: declaration.name.text, imported: declaration.name.text, file, scope, typeOnly: false, component: false });
+                }
+        }
+        if (ts.isExportDeclaration(statement) && statement.exportClause && ts.isNamedExports(statement.exportClause)) {
+            for (const element of statement.exportClause.elements)
+                result.push({ name: element.name.text, imported: element.name.text, file, scope, typeOnly: statement.isTypeOnly || element.isTypeOnly, component: false });
+        }
+    }
+}
+/** Construye el registro a partir de exports sintácticos, sin ejecutar módulos de la aplicación. */
+export async function discoverAutoImports(root) {
+    const result = builtins(root);
+    const config = await loadMeekoConfig(root);
+    const sources = await resolveConfigSources(root, config);
+    for (const source of sources) {
+        for (const directory of configuredDirectories(config.imports?.serverDirs)) {
+            for (const file of await filesIn(join(source.root, directory))) {
+                addFileImports(result, source.root, directory, file, extname(file) === ".meeko" ? undefined : await readFile(file, "utf8"));
+            }
+        }
+    }
+    return result;
+}
+/** Same static registry used by the synchronous VS Code Language Service. */
+export function discoverAutoImportsSync(root) {
+    const result = builtins(root);
+    const config = readMeekoConfigSync(root);
+    const sourceRoots = [resolve(root)];
+    for (const entry of [...(config.extends ?? []), ...(config.modules ?? [])]) {
+        const sourceRoot = resolve(root, entry);
+        const path = relative(root, sourceRoot);
+        if (path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path))
+            throw new Error(`Configured autoimport source escapes project root: ${entry}`);
+        sourceRoots.push(sourceRoot);
+    }
+    for (const sourceRoot of sourceRoots) {
+        for (const directory of configuredDirectories(config.imports?.serverDirs)) {
+            for (const file of filesInSync(join(sourceRoot, directory))) {
+                addFileImports(result, sourceRoot, directory, file, extname(file) === ".meeko" ? undefined : readFileSync(file, "utf8"));
+            }
+        }
+    }
+    return result;
+}
+function configuredDirectories(serverDirs) {
+    const result = new Set(directories);
+    for (const raw of serverDirs ?? []) {
+        const directory = raw.replaceAll("\\", "/").replace(/\/$/, "");
+        const parts = directory.split("/");
+        if (parts[0] !== "server" || parts.length < 2 || parts.some((part) => !part || part === "." || part === "..")) {
+            throw new Error(`Autoimport serverDir must be a relative path under server/: ${raw}`);
+        }
+        result.add(directory);
+    }
+    return [...result];
+}
+function bindingNames(name, names) {
+    if (ts.isIdentifier(name))
+        names.add(name.text);
+    else
+        for (const element of name.elements)
+            if (ts.isBindingElement(element))
+                bindingNames(element.name, names);
+}
+function scopeNames(node) {
+    const names = new Set();
+    if (ts.isFunctionLike(node)) {
+        for (const parameter of node.parameters)
+            bindingNames(parameter.name, names);
+        for (const parameter of node.typeParameters ?? [])
+            names.add(parameter.name.text);
+    }
+    if (ts.isCatchClause(node) && node.variableDeclaration)
+        bindingNames(node.variableDeclaration.name, names);
+    if (ts.isForStatement(node) && node.initializer && ts.isVariableDeclarationList(node.initializer)) {
+        for (const declaration of node.initializer.declarations)
+            bindingNames(declaration.name, names);
+    }
+    if ((ts.isForOfStatement(node) || ts.isForInStatement(node)) && ts.isVariableDeclarationList(node.initializer)) {
+        for (const declaration of node.initializer.declarations)
+            bindingNames(declaration.name, names);
+    }
+    if (ts.isSourceFile(node) || ts.isBlock(node)) {
+        for (const statement of node.statements) {
+            if (ts.isVariableStatement(statement))
+                for (const declaration of statement.declarationList.declarations)
+                    bindingNames(declaration.name, names);
+            if ((ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement) || ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement) || ts.isEnumDeclaration(statement)) && statement.name)
+                names.add(statement.name.text);
+            if (ts.isImportDeclaration(statement)) {
+                const clause = statement.importClause;
+                if (clause?.name)
+                    names.add(clause.name.text);
+                if (clause?.namedBindings) {
+                    if (ts.isNamespaceImport(clause.namedBindings))
+                        names.add(clause.namedBindings.name.text);
+                    else
+                        for (const element of clause.namedBindings.elements)
+                            names.add(element.name.text);
+                }
+            }
+        }
+    }
+    return names;
+}
+function introducesScope(node) {
+    return ts.isSourceFile(node) || ts.isBlock(node) || ts.isFunctionLike(node) || ts.isCatchClause(node)
+        || ts.isForStatement(node) || ts.isForOfStatement(node) || ts.isForInStatement(node);
+}
+function isReference(node) {
+    const parent = node.parent;
+    if (!parent)
+        return false;
+    if (ts.isPropertyAccessExpression(parent) && parent.name === node)
+        return false;
+    if (ts.isQualifiedName(parent) && parent.right === node)
+        return false;
+    if (ts.isPropertyAssignment(parent) && parent.name === node)
+        return false;
+    if (ts.isPropertyDeclaration(parent) && parent.name === node)
+        return false;
+    if (ts.isMethodDeclaration(parent) && parent.name === node)
+        return false;
+    if (ts.isImportSpecifier(parent) || ts.isExportSpecifier(parent) || ts.isImportClause(parent) || ts.isNamespaceImport(parent))
+        return false;
+    if (ts.isTypeReferenceNode(parent) && parent.typeName === node)
+        return true;
+    if (ts.isParameter(parent) && parent.name === node)
+        return false;
+    if (ts.isTypeParameterDeclaration(parent) && parent.name === node)
+        return false;
+    if (ts.isVariableDeclaration(parent) && parent.name === node)
+        return false;
+    if ((ts.isFunctionDeclaration(parent) || ts.isClassDeclaration(parent) || ts.isInterfaceDeclaration(parent) || ts.isTypeAliasDeclaration(parent)) && parent.name === node)
+        return false;
+    if (ts.isPropertySignature(parent) && parent.name === node)
+        return false;
+    return true;
+}
+/** Añade imports ESM para referencias libres del módulo generado. */
+export function applyAutoImports(code, filename, registry, target) {
+    const ast = ts.createSourceFile(filename, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const referenced = new Set();
+    const visit = (node, scopes) => {
+        const active = introducesScope(node) ? [...scopes, scopeNames(node)] : scopes;
+        if (ts.isIdentifier(node) && isReference(node) && !active.some((scope) => scope.has(node.text)))
+            referenced.add(node.text);
+        ts.forEachChild(node, (child) => visit(child, active));
+    };
+    visit(ast, []);
+    const imports = [];
+    for (const name of [...referenced].sort()) {
+        const candidates = registry.filter((entry) => entry.name === name);
+        if (candidates.length === 0)
+            continue;
+        const allowed = candidates.filter((entry) => entry.scope === "shared" || entry.scope === target);
+        if (allowed.length === 0)
+            throw new Error(`Autoimport ${name} is unavailable in ${target} scope`);
+        if (allowed.length > 1)
+            throw new Error(`Ambiguous autoimport ${name}: ${allowed.map((entry) => entry.file).join(", ")}`);
+        const entry = allowed[0];
+        let specifier = entry.specifier ?? relative(resolve(filename, ".."), entry.file).replaceAll("\\", "/");
+        if (!entry.specifier && !specifier.startsWith("."))
+            specifier = `./${specifier}`;
+        if (!entry.component && !entry.specifier)
+            specifier = specifier.replace(/\.[cm]?ts$/, ".js");
+        if (entry.component)
+            imports.push(`import * as ${name} from ${JSON.stringify(specifier)};`);
+        else
+            imports.push(`import ${entry.typeOnly ? "type " : ""}{ ${entry.imported} as ${name} } from ${JSON.stringify(specifier)};`);
+    }
+    return imports.length ? `${imports.join("\n")}\n${code}` : code;
+}
+/** Transforma un SFC usando exactamente el mismo compilador que el plugin Vite. */
+export function transformAutoImports(source, filename, code, registry, target) {
+    parseSfc(source, filename);
+    return applyAutoImports(code, filename, registry, target);
+}
+/** Compile result shared by Vite, CLI checks and declaration generation. */
+export async function compileWithAutoImports(source, filename, options = {}, target = "client") {
+    const compiled = compile(source, filename, options);
+    const registry = await discoverAutoImports(projectRoot(filename));
+    const code = transformAutoImports(source, filename, compiled.code, registry, target);
+    const offset = code.length - compiled.code.length;
+    return {
+        ...compiled,
+        code,
+        mappings: offset ? compiled.mappings.map((mapping) => ({ ...mapping, generatedStart: mapping.generatedStart + offset, generatedEnd: mapping.generatedEnd + offset })) : compiled.mappings,
+    };
+}
+//# sourceMappingURL=autoimports.js.map