@meekojs/meeko 0.0.3 → 0.1.0

package/README.md

@@ -1,26 +1,27 @@
 # Meeko
 
 <p align="center">
-  <img src="assets/brand/meeko-logo.png" alt="Carita de Meeko, una gatita de ojos azules, orejas oscuras y pelaje crema" width="200" />
+  <img src="https://raw.githubusercontent.com/meekojs/meeko/main/assets/brand/meeko-logo.png" alt="Carita de Meeko, una gatita de ojos azules, orejas oscuras y pelaje crema" width="200" />
 </p>
 
 Este proyecto está dedicado a mi gatita Meeko. Su carita inspira el logo que lo acompaña.
 
 **Meeko** es un motor experimental de componentes para TypeScript. Los archivos `.meeko` combinan lógica tipada, plantilla y estilos; el compilador produce HTML para SSR y conecta la reactividad al HTML existente durante la hidratación.
 
-El código se distribuye bajo la [licencia MIT](LICENSE). El paquete público se llama `@meekojs/meeko`; la CLI se invoca como `meeko` y el plugin de Vite se importa desde `@meekojs/meeko/vite`.
+El código se distribuye bajo la [licencia MIT](https://github.com/meekojs/meeko/blob/main/LICENSE). El paquete público se llama `@meekojs/meeko`; la CLI se invoca como `meeko` y el plugin de Vite se importa desde `@meekojs/meeko/vite`.
 
 El proyecto está en etapa temprana. Ya funciona el recorrido completo de un contador renderizado en servidor, hidratado en navegador y actualizado por señales. La sintaxis y las API públicas pueden cambiar antes de la primera versión estable.
 
-- [Arquitectura y contratos](docs/architecture.md)
-- [API y límites de compatibilidad](docs/api.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)
+- [Arquitectura y contratos](https://github.com/meekojs/meeko/blob/main/docs/architecture.md)
+- [API y límites de compatibilidad](https://github.com/meekojs/meeko/blob/main/docs/api.md)
+- [Aplicaciones full-stack con Meeko](https://github.com/meekojs/meeko/blob/main/docs/framework.md)
+- [Plan de desarrollo y criterios de aceptación](https://github.com/meekojs/meeko/blob/main/docs/roadmap.md)
+- [Comparativa reproducible con Vue](https://github.com/meekojs/meeko/blob/main/docs/benchmarks.md)
+- [DevTools para depurar componentes](https://github.com/meekojs/meeko/blob/main/docs/devtools.md)
+- [Aplicación piloto SSR](https://github.com/meekojs/meeko/blob/main/examples/pilot/README.md)
+- [Publicación y verificaciones](https://github.com/meekojs/meeko/blob/main/docs/releasing.md)
+- [Historial de cambios](https://github.com/meekojs/meeko/blob/main/CHANGELOG.md)
+- [Guía para contribuir](https://github.com/meekojs/meeko/blob/main/CONTRIBUTING.md)
 
 ## Requisitos
 
@@ -61,6 +62,22 @@ Abre `http://127.0.0.1:4173`. `npm run check` genera los tipos del componente y
 
 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, middleware de `app/` y `server/`, SSR, estado por petición, API, RPC, sesiones y WebSocket con el mismo compilador y runtime. En este checkout, 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](https://github.com/meekojs/meeko/blob/main/docs/framework.md) explica configuración, autoimports, rutas, middleware, despliegue y seguridad. Los comandos simplificados del proyecto están disponibles desde `0.1.0`.
+
 ## Estructura
 
 | Ruta | Responsabilidad |
@@ -107,7 +124,7 @@ pnpm run vite:build
 
 El plugin `@meekojs/meeko/vite` transforma imports de `.meeko` en cliente y SSR y procesa el CSS del componente. En desarrollo, HMR sustituye las instancias hidratadas sin recargar la página, conserva las señales editables que mantienen su nombre y aplica cambios de CSS. Un cambio en el runtime del motor provoca una recarga completa.
 
-El ejemplo Vite muestra [Meeko DevTools](docs/devtools.md) durante el desarrollo: permite seleccionar cada instancia, revisar props y señales, seguir eventos y activar un punto de parada cuando cambia una señal. También hay un panel local para Chrome DevTools. La funcionalidad se incorpora al paquete a partir de `0.0.2`.
+El ejemplo Vite muestra [Meeko DevTools](https://github.com/meekojs/meeko/blob/main/docs/devtools.md) durante el desarrollo: permite seleccionar cada instancia, revisar props y señales, seguir eventos y activar un punto de parada cuando cambia una señal. También hay un panel local para Chrome DevTools. La funcionalidad se incorpora al paquete a partir de `0.0.2`.
 
 `vite:types` genera declaraciones `.d.meeko.ts` para los imports de la aplicación y comprueba el consumidor con TypeScript 7 y `allowArbitraryExtensions`. Las declaraciones del ejemplo se regeneran; no se versionan.
 
@@ -127,21 +144,23 @@ La aplicación debe pasar **las mismas props** al render y a `hydrate`. `renderW
 
 ## 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.
+[`examples/pilot`](https://github.com/meekojs/meeko/blob/main/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.
+`defineProps<Props>({ count: 0 })` declara defaults sin otra macro: `count` será opcional al usar el componente y estará definido dentro de él. Consulta las reglas y límites en la [guía de la API](https://github.com/meekojs/meeko/blob/main/docs/api.md#valores-por-defecto-en-defineprops).
+
+`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](https://github.com/meekojs/meeko/blob/main/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](https://github.com/meekojs/meeko/blob/main/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.
 
 Los nombres e identificadores de código se escriben en inglés. La API pública y sus contratos llevan JSDoc en español.
 
-La [extensión local de VS Code](editors/vscode/README.md) comparte los diagnósticos del CLI y ofrece completado, navegación, hover, renombrado y formato en script y plantilla. El VSIX se validó en un host VS Code aislado con un proyecto consumidor externo; su README explica cómo repetir la prueba y las limitaciones actuales.
+La [extensión local de VS Code](https://github.com/meekojs/meeko/blob/main/editors/vscode/README.md) comparte los diagnósticos del CLI y ofrece completado, navegación, hover, renombrado y formato en script y plantilla. El VSIX se validó en un host VS Code aislado con un proyecto consumidor externo; su README explica cómo repetir la prueba y las limitaciones actuales.
 
 ## Alcance actual
 

package/dist/autoimports-ts.d.ts

@@ -0,0 +1,26 @@
+import type { AutoImport, ImportScope } from "./autoimports.js";
+export type TypeScriptScope = Exclude<ImportScope, "app">;
+/** Selects a source scope without executing config; Vite may pass resolved roots for dynamic config. */
+export declare function typeScriptScope(root: string, filename: string, sourceRoots?: readonly 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[], sourceRoots?: readonly string[]): 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,183 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import ts from "@typescript/typescript6";
+import { applyAutoImports, discoverAutoImports } from "./autoimports.js";
+import { readMeekoConfigSync } from "./framework/config.js";
+function within(root, filename) {
+    const path = relative(resolve(root), resolve(filename));
+    return path === ".." || path.startsWith(`..${sep}`) || path.startsWith("/") ? undefined : path.replaceAll("\\", "/");
+}
+function scopeWithin(sourceRoot, filename) {
+    const path = within(sourceRoot, filename);
+    if (!path || !/\.[cm]?tsx?$/.test(path) || /\.(?:test|spec|d)\.[cm]?tsx?$/.test(path) ||
+        !/^(?:app|server|shared)\//.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;
+}
+/** Selects a source scope without executing config; Vite may pass resolved roots for dynamic config. */
+export function typeScriptScope(root, filename, sourceRoots) {
+    const config = sourceRoots ? undefined : readMeekoConfigSync(root);
+    const configured = sourceRoots ?? [
+        ...(config?.extends ?? []),
+        ...(config?.modules ?? []),
+    ].map((entry) => resolve(root, entry));
+    for (const sourceRoot of [...configured, root].sort((a, b) => b.length - a.length)) {
+        const scope = scopeWithin(sourceRoot, filename);
+        if (scope)
+            return scope;
+    }
+    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 || entry.scope === "app")));
+}
+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);
+    }
+}
+function projectCompilerOptions(root) {
+    const config = ts.findConfigFile(root, ts.sys.fileExists, "tsconfig.json");
+    if (!config)
+        return {
+            target: ts.ScriptTarget.Latest,
+            module: ts.ModuleKind.NodeNext,
+            moduleResolution: ts.ModuleResolutionKind.NodeNext,
+            noEmit: true,
+            skipLibCheck: true,
+        };
+    const loaded = ts.readConfigFile(config, ts.sys.readFile);
+    if (loaded.error)
+        throw new Error(ts.flattenDiagnosticMessageText(loaded.error.messageText, "\n"));
+    return { ...ts.parseJsonConfigFileContent(loaded.config, ts.sys, dirname(config)).options, noEmit: true };
+}
+function typeTargets(root, entries) {
+    const files = [...new Set(entries.filter((entry) => entry.typeOnly && !entry.specifier).map((entry) => entry.file))];
+    const targets = new Map();
+    if (files.length === 0)
+        return targets;
+    const program = ts.createProgram({ rootNames: files, options: projectCompilerOptions(root) });
+    const checker = program.getTypeChecker();
+    for (const entry of entries) {
+        if (!entry.typeOnly || entry.specifier)
+            continue;
+        const file = program.getSourceFile(entry.file);
+        const moduleSymbol = file && checker.getSymbolAtLocation(file);
+        const exported = moduleSymbol && checker.getExportsOfModule(moduleSymbol).find((symbol) => symbol.name === entry.imported);
+        if (!exported)
+            continue;
+        const symbol = exported.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(exported) : exported;
+        const declaration = symbol.declarations?.[0];
+        if (!declaration)
+            continue;
+        targets.set(`${entry.file}\0${entry.imported}`, {
+            file: declaration.getSourceFile().fileName,
+            imported: symbol.name,
+        });
+    }
+    return targets;
+}
+/** 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);
+    const resolvedTypes = typeTargets(root, registry);
+    await mkdir(outputDirectory, { recursive: true });
+    const outputs = {};
+    for (const scope of ["client", "server", "shared"]) {
+        const entries = scopeEntries(registry, scope);
+        assertNoCollisions(entries, scope);
+        const typeModules = new Map();
+        const imports = [];
+        const declarations = entries.sort((a, b) => a.name.localeCompare(b.name)).map((entry) => {
+            const specifier = JSON.stringify(publicSpecifier(outputDirectory, entry));
+            if (entry.typeOnly) {
+                const resolvedTarget = resolvedTypes.get(`${entry.file}\0${entry.imported}`);
+                const target = resolvedTarget ?? entry;
+                const targetSpecifier = resolvedTarget
+                    ? JSON.stringify(publicSpecifier(outputDirectory, { ...entry, ...resolvedTarget }))
+                    : specifier;
+                let namespace = typeModules.get(targetSpecifier);
+                if (!namespace) {
+                    namespace = `__meeko_type_${typeModules.size}`;
+                    typeModules.set(targetSpecifier, namespace);
+                    // A declaration-only namespace alias preserves the original symbol's
+                    // generic parameters, including private constraints and defaults.
+                    imports.push(`import * as ${namespace} from ${targetSpecifier};`);
+                }
+                return `  export import ${entry.name} = ${namespace}.${target.imported};`;
+            }
+            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.", ...imports, "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, sourceRoots) {
+    const scope = typeScriptScope(root, filename, sourceRoots);
+    if (!scope)
+        return undefined;
+    if (scope === "shared") {
+        const transformed = applyAutoImports(source, filename, registry, "shared");
+        return transformed === source ? undefined : transformed;
+    }
+    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 { dirname, 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\";\nimport { readMeekoConfigSync } from \"./framework/config.js\";\n\nexport type TypeScriptScope = Exclude<ImportScope, \"app\">;\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\nfunction scopeWithin(sourceRoot: string, filename: string): TypeScriptScope | undefined {\n  const path = within(sourceRoot, filename);\n  if (!path || !/\\.[cm]?tsx?$/.test(path) || /\\.(?:test|spec|d)\\.[cm]?tsx?$/.test(path) ||\n    !/^(?:app|server|shared)\\//.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\n/** Selects a source scope without executing config; Vite may pass resolved roots for dynamic config. */\nexport function typeScriptScope(root: string, filename: string, sourceRoots?: readonly string[]): TypeScriptScope | undefined {\n  const config = sourceRoots ? undefined : readMeekoConfigSync(root);\n  const configured = sourceRoots ?? [\n    ...(config?.extends ?? []),\n    ...(config?.modules ?? []),\n  ].map((entry) => resolve(root, entry));\n  for (const sourceRoot of [...configured, root].sort((a, b) => b.length - a.length)) {\n    const scope = scopeWithin(sourceRoot, filename);\n    if (scope) return scope;\n  }\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 || entry.scope === \"app\")));\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\ninterface TypeTarget {\n  readonly file: string;\n  readonly imported: string;\n}\n\nfunction projectCompilerOptions(root: string): ts.CompilerOptions {\n  const config = ts.findConfigFile(root, ts.sys.fileExists, \"tsconfig.json\");\n  if (!config) return {\n    target: ts.ScriptTarget.Latest,\n    module: ts.ModuleKind.NodeNext,\n    moduleResolution: ts.ModuleResolutionKind.NodeNext,\n    noEmit: true,\n    skipLibCheck: true,\n  };\n  const loaded = ts.readConfigFile(config, ts.sys.readFile);\n  if (loaded.error) throw new Error(ts.flattenDiagnosticMessageText(loaded.error.messageText, \"\\n\"));\n  return { ...ts.parseJsonConfigFileContent(loaded.config, ts.sys, dirname(config)).options, noEmit: true };\n}\n\nfunction typeTargets(root: string, entries: readonly AutoImport[]): Map<string, TypeTarget> {\n  const files = [...new Set(entries.filter((entry) => entry.typeOnly && !entry.specifier).map((entry) => entry.file))];\n  const targets = new Map<string, TypeTarget>();\n  if (files.length === 0) return targets;\n  const program = ts.createProgram({ rootNames: files, options: projectCompilerOptions(root) });\n  const checker = program.getTypeChecker();\n  for (const entry of entries) {\n    if (!entry.typeOnly || entry.specifier) continue;\n    const file = program.getSourceFile(entry.file);\n    const moduleSymbol = file && checker.getSymbolAtLocation(file);\n    const exported = moduleSymbol && checker.getExportsOfModule(moduleSymbol).find((symbol) => symbol.name === entry.imported);\n    if (!exported) continue;\n    const symbol = exported.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(exported) : exported;\n    const declaration = symbol.declarations?.[0];\n    if (!declaration) continue;\n    targets.set(`${entry.file}\\0${entry.imported}`, {\n      file: declaration.getSourceFile().fileName,\n      imported: symbol.name,\n    });\n  }\n  return targets;\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  const resolvedTypes = typeTargets(root, registry);\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 typeModules = new Map<string, string>();\n    const imports: string[] = [];\n    const declarations = entries.sort((a, b) => a.name.localeCompare(b.name)).map((entry) => {\n      const specifier = JSON.stringify(publicSpecifier(outputDirectory, entry));\n      if (entry.typeOnly) {\n        const resolvedTarget = resolvedTypes.get(`${entry.file}\\0${entry.imported}`);\n        const target = resolvedTarget ?? entry;\n        const targetSpecifier = resolvedTarget\n          ? JSON.stringify(publicSpecifier(outputDirectory, { ...entry, ...resolvedTarget }))\n          : specifier;\n        let namespace = typeModules.get(targetSpecifier);\n        if (!namespace) {\n          namespace = `__meeko_type_${typeModules.size}`;\n          typeModules.set(targetSpecifier, namespace);\n          // A declaration-only namespace alias preserves the original symbol's\n          // generic parameters, including private constraints and defaults.\n          imports.push(`import * as ${namespace} from ${targetSpecifier};`);\n        }\n        return `  export import ${entry.name} = ${namespace}.${target.imported};`;\n      }\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.\", ...imports, \"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[], sourceRoots?: readonly string[]): string | undefined {\n  const scope = typeScriptScope(root, filename, sourceRoots);\n  if (!scope) return undefined;\n  if (scope === \"shared\") {\n    const transformed = applyAutoImports(source, filename, registry, \"shared\");\n    return transformed === source ? undefined : transformed;\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" | "app";
+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" | "shared"): 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>;