@meekojs/meeko 0.0.4 → 0.1.0

package/dist/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, readFile, readdir, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\n\n/** Entradas que puede dejar un gestor de paquetes antes de generar el proyecto. */\nconst packageScaffoldEntries = new Set([\"package.json\", \"package-lock.json\", \"pnpm-lock.yaml\", \"pnpm-workspace.yaml\", \"yarn.lock\", \"bun.lock\", \"bun.lockb\", \"node_modules\", \".npmrc\", \".git\"]);\n\n/** Comprueba que un valor JSON sea un objeto de configuración. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Archivos autocontenidos del proyecto inicial, incluidos en la CLI publicada. */\nconst starterFiles: Readonly<Record<string, string>> = {\n  \".gitignore\": \"node_modules/\\ndist/\\n.meeko/\\n\",\n  \"index.html\": `<!doctype html>\n<html lang=\"es\">\n  <head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"><title>Meeko SSR</title></head>\n  <body><div id=\"app\"></div><script type=\"module\" src=\"/src/entry-client.ts\"></script></body>\n</html>\n`,\n  \"vite.config.ts\": `import { defineConfig } from \"vite\";\nimport { meeko } from \"@meekojs/meeko/vite\";\n\nexport default defineConfig({ plugins: [meeko()] });\n`,\n  \"tsconfig.json\": `{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\", \"module\": \"NodeNext\", \"moduleResolution\": \"NodeNext\",\n    \"lib\": [\"ES2022\", \"DOM\"], \"types\": [\"node\", \"vite/client\"],\n    \"strict\": true, \"noEmit\": true, \"allowArbitraryExtensions\": true,\n    \"rootDirs\": [\"src\", \".meeko/types/src\"],\n    \"skipLibCheck\": true\n  },\n  \"include\": [\"src/**/*.ts\", \"vite.config.ts\", \".meeko/types/routes.d.ts\"]\n}\n`,\n  \"src/App.meeko\": `<script lang=\"ts\">\nimport { signal } from \"@meekojs/meeko\";\n\n/** Propiedades transferidas desde el servidor. */\nexport interface Props { initial: number }\n\nconst props = defineProps<Props>();\nconst count = signal(props.initial);\n</script>\n\n<template>\n  <main>\n    <h1>Meeko SSR</h1>\n    <button type=\"button\" on:click=\"() => count.value++\">Contador: {count.value}</button>\n  </main>\n</template>\n\n<style scoped>\nmain { max-width: 40rem; margin: 4rem auto; font: 1.2rem system-ui; }\nbutton { cursor: pointer; padding: .65rem 1rem; }\n</style>\n`,\n  \"src/entry-server.ts\": `import { serializeJson } from \"@meekojs/meeko\";\nimport { css, renderWithState } from \"./App.meeko\";\n\n/** Genera HTML y estado inicial desde el mismo componente que hidrata el cliente. */\nexport function renderPage(clientSource: string, initial = 1): string {\n  const props = { initial };\n  const rendered = renderWithState(props);\n  return '<!doctype html><html lang=\"es\"><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title>Meeko SSR</title><style>'\n    + css + '</style></head><body><div id=\"app\">' + rendered.html + '</div><script id=\"meeko-payload\" type=\"application/json\">'\n    + serializeJson({ props, state: rendered.state }) + '</script><script type=\"module\" src=\"' + clientSource + '\"></script></body></html>';\n}\n`,\n  \"src/entry-client.ts\": `import { hydrate } from \"./App.meeko\";\nimport type { HotState } from \"@meekojs/meeko\";\n\nconst root = document.getElementById(\"app\");\nconst payloadNode = document.getElementById(\"meeko-payload\");\nif (!root || !payloadNode?.textContent) throw new Error(\"Missing SSR root or payload\");\nconst payload: unknown = JSON.parse(payloadNode.textContent);\nif (typeof payload !== \"object\" || payload === null || !(\"props\" in payload) || !(\"state\" in payload)) throw new TypeError(\"Invalid SSR payload\");\nconst { props, state } = payload;\nif (typeof props !== \"object\" || props === null || !(\"initial\" in props) || typeof props.initial !== \"number\" || !Number.isFinite(props.initial)) throw new TypeError(\"Invalid SSR props\");\nif (typeof state !== \"object\" || state === null || !(\"count\" in state) || typeof state.count !== \"number\" || !Number.isFinite(state.count)) throw new TypeError(\"Invalid SSR state\");\nhydrate(root, { initial: props.initial }, { count: state.count } satisfies HotState);\n`,\n  \"server.mjs\": `import { createServer } from \"node:http\";\nimport { readFile } from \"node:fs/promises\";\nimport { dirname, extname, resolve, sep } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { createServer as createViteServer } from \"vite\";\n\nconst root = dirname(fileURLToPath(import.meta.url));\nconst production = process.argv.includes(\"--production\");\nconst vite = production ? undefined : await createViteServer({ root, server: { middlewareMode: true }, appType: \"custom\" });\nconst clientRoot = resolve(root, \"dist/client\");\nlet clientSource = \"/src/entry-client.ts\";\nif (production) {\n  const manifest = JSON.parse(await readFile(resolve(clientRoot, \".vite/manifest.json\"), \"utf8\"));\n  const entry = manifest[\"index.html\"];\n  if (!entry?.file) throw new Error(\"Missing Vite client entry\");\n  clientSource = \"/\" + entry.file;\n}\n\nconst contentTypes = { \".js\": \"text/javascript\", \".css\": \"text/css\", \".png\": \"image/png\", \".svg\": \"image/svg+xml\", \".ico\": \"image/x-icon\" };\nconst server = createServer(async (request, response) => {\n  try {\n    const path = new URL(request.url ?? \"/\", \"http://localhost\").pathname;\n    if (path === \"/\") {\n      const module = vite ? await vite.ssrLoadModule(\"/src/entry-server.ts\") : await import(pathToFileURL(resolve(root, \"dist/server/entry-server.js\")).href);\n      const html = module.renderPage(clientSource);\n      response.writeHead(200, { \"content-type\": \"text/html; charset=utf-8\" });\n      response.end(vite ? await vite.transformIndexHtml(path, html) : html);\n      return;\n    }\n    if (vite) {\n      vite.middlewares(request, response, () => { response.writeHead(404); response.end(); });\n      return;\n    }\n    const file = resolve(clientRoot, \".\" + path);\n    if (!file.startsWith(clientRoot + sep)) { response.writeHead(403); response.end(); return; }\n    const body = await readFile(file);\n    response.writeHead(200, { \"content-type\": contentTypes[extname(file)] ?? \"application/octet-stream\" });\n    response.end(body);\n  } catch (error) {\n    console.error(error);\n    response.writeHead(500);\n    response.end(\"Internal server error\");\n  }\n});\n\nconst port = Number(process.env.PORT ?? 4173);\nserver.listen(port, \"127.0.0.1\", () => console.log(\"http://127.0.0.1:\" + port));\nprocess.on(\"SIGINT\", () => { server.close(); void vite?.close(); });\n`,\n  \"README.md\": `# Meeko SSR starter\n\nProyecto inicial con renderizado en servidor e hidratación del mismo componente \\`.meeko\\`.\n\n\\`\\`\\`sh\nnpm install\nnpm run dev\n\\`\\`\\`\n\nAbre http://127.0.0.1:4173. El servidor produce HTML y transfiere las props y señales al navegador.\n\n\\`npm run check\\` genera los tipos del componente y comprueba TypeScript. \\`npm run build\\` compila cliente y servidor; \\`npm start\\` sirve ambas compilaciones con SSR.\n`,\n};\n\n/** Crea un proyecto SSR independiente sin sobrescribir archivos del usuario. */\nexport async function initProject(directory: string): Promise<string> {\n  const target = resolve(directory);\n  const name = basename(target).toLowerCase().replace(/[^a-z0-9._-]+/g, \"-\").replace(/^[._-]+|[._-]+$/g, \"\") || \"meeko-app\";\n  const packageMetadata: unknown = JSON.parse(await readFile(new URL(\"../package.json\", import.meta.url), \"utf8\"));\n  if (typeof packageMetadata !== \"object\" || packageMetadata === null || !(\"version\" in packageMetadata) || typeof packageMetadata.version !== \"string\") {\n    throw new Error(\"Meeko package version is unavailable\");\n  }\n  let existingEntries: string[] = [];\n  try {\n    if (!(await stat(target)).isDirectory()) throw new Error(`Destination is not a directory: ${target}`);\n    existingEntries = await readdir(target);\n  } catch (error) {\n    if (!(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")) throw error;\n  }\n  const unexpected = existingEntries.filter((entry) => !packageScaffoldEntries.has(entry));\n  if (unexpected.length > 0 || (existingEntries.length > 0 && !existingEntries.includes(\"package.json\"))) {\n    throw new Error(`Destination is not empty: ${target}${unexpected.length > 0 ? ` (${unexpected.join(\", \")})` : \"\"}`);\n  }\n  const existing: unknown = existingEntries.includes(\"package.json\") ? JSON.parse(await readFile(join(target, \"package.json\"), \"utf8\")) : {};\n  if (!isRecord(existing)) throw new Error(`Invalid package.json in ${target}`);\n  const existingScripts = existing.scripts ?? {};\n  const existingDependencies = existing.dependencies ?? {};\n  const existingDevDependencies = existing.devDependencies ?? {};\n  const existingEngines = existing.engines ?? {};\n  if (!isRecord(existingScripts) || !isRecord(existingDependencies) || !isRecord(existingDevDependencies) || !isRecord(existingEngines)) {\n    throw new Error(`Invalid package.json in ${target}`);\n  }\n  const scripts = {\n    dev: \"node server.mjs\",\n    check: \"meeko types src/App.meeko && tsc --noEmit\",\n    build: \"npm run check && vite build --outDir dist/client --manifest && vite build --ssr src/entry-server.ts --outDir dist/server\",\n    start: \"node server.mjs --production\",\n  };\n  const devDependencies = { \"@types/node\": \"^24.0.0\", typescript: \"^7.0.2\", vite: \"^8.3.5\" };\n  for (const command of Object.keys(scripts)) {\n    if (command in existingScripts) throw new Error(`Destination already defines the ${command} script: ${target}`);\n  }\n  if (Object.keys(existingDependencies).some((dependency) => dependency !== \"@meekojs/meeko\") || Object.keys(existingDevDependencies).some((dependency) => !(dependency in devDependencies))) {\n    throw new Error(`Destination contains other dependencies: ${target}`);\n  }\n  const packageFile = JSON.stringify({\n    ...existing,\n    name: typeof existing.name === \"string\" ? existing.name : name,\n    private: true,\n    type: \"module\",\n    engines: { ...existingEngines, node: \">=24\" },\n    scripts: { ...existingScripts, ...scripts },\n    dependencies: { ...existingDependencies, \"@meekojs/meeko\": packageMetadata.version },\n    devDependencies: { ...existingDevDependencies, ...devDependencies },\n  }, null, 2) + \"\\n\";\n  await mkdir(target, { recursive: true });\n  for (const [filename, content] of Object.entries(starterFiles)) {\n    const path = join(target, filename);\n    await mkdir(dirname(path), { recursive: true });\n    await writeFile(path, content, { encoding: \"utf8\", flag: \"wx\" });\n  }\n  await writeFile(join(target, \"package.json\"), packageFile, { encoding: \"utf8\", flag: existingEntries.includes(\"package.json\") ? \"w\" : \"wx\" });\n  return target;\n}\n"]}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, readFile, readdir, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\n\n/** Entradas que puede dejar un gestor de paquetes antes de generar el proyecto. */\nconst packageScaffoldEntries = new Set([\"package.json\", \"package-lock.json\", \"pnpm-lock.yaml\", \"pnpm-workspace.yaml\", \"yarn.lock\", \"bun.lock\", \"bun.lockb\", \"node_modules\", \".npmrc\", \".git\"]);\n\n/** Comprueba que un valor JSON sea un objeto de configuración. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Archivos autocontenidos del proyecto inicial, incluidos en la CLI publicada. */\nconst starterFiles: Readonly<Record<string, string>> = {\n  \".gitignore\": \"node_modules/\\ndist/\\n.meeko/\\n\",\n  \"index.html\": `<!doctype html>\n<html lang=\"es\">\n  <head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"><title>Meeko SSR</title></head>\n  <body><div id=\"app\"></div><script type=\"module\" src=\"/src/entry-client.ts\"></script></body>\n</html>\n`,\n  \"vite.config.ts\": `import { defineConfig } from \"vite\";\nimport { meeko } from \"@meekojs/meeko/vite\";\n\nexport default defineConfig({ plugins: [meeko()] });\n`,\n  \"tsconfig.json\": `{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\", \"module\": \"NodeNext\", \"moduleResolution\": \"NodeNext\",\n    \"lib\": [\"ES2022\", \"DOM\"], \"types\": [\"node\", \"vite/client\"],\n    \"strict\": true, \"noEmit\": true, \"allowArbitraryExtensions\": true,\n    \"rootDirs\": [\"src\", \".meeko/types/src\"],\n    \"skipLibCheck\": true\n  },\n  \"include\": [\"src/**/*.ts\", \"vite.config.ts\", \".meeko/types/routes.d.ts\"]\n}\n`,\n  \"src/App.meeko\": `<script lang=\"ts\">\nimport { signal } from \"@meekojs/meeko\";\n\n/** Propiedades transferidas desde el servidor. */\nexport interface Props { initial: number }\n\nconst props = defineProps<Props>();\nconst count = signal(props.initial);\n</script>\n\n<template>\n  <main>\n    <h1>Meeko SSR</h1>\n    <button type=\"button\" on:click=\"() => count.value++\">Contador: {count.value}</button>\n  </main>\n</template>\n\n<style scoped>\nmain { max-width: 40rem; margin: 4rem auto; font: 1.2rem system-ui; }\nbutton { cursor: pointer; padding: .65rem 1rem; }\n</style>\n`,\n  \"src/entry-server.ts\": `import { serializeJson } from \"@meekojs/meeko\";\nimport { css, renderWithState } from \"./App.meeko\";\n\n/** Genera HTML y estado inicial desde el mismo componente que hidrata el cliente. */\nexport function renderPage(clientSource: string, initial = 1): string {\n  const props = { initial };\n  const rendered = renderWithState(props);\n  return '<!doctype html><html lang=\"es\"><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title>Meeko SSR</title><style>'\n    + css + '</style></head><body><div id=\"app\">' + rendered.html + '</div><script id=\"meeko-payload\" type=\"application/json\">'\n    + serializeJson({ props, state: rendered.state }) + '</script><script type=\"module\" src=\"' + clientSource + '\"></script></body></html>';\n}\n`,\n  \"src/entry-client.ts\": `import { hydrate } from \"./App.meeko\";\nimport type { HotState } from \"@meekojs/meeko\";\n\nconst root = document.getElementById(\"app\");\nconst payloadNode = document.getElementById(\"meeko-payload\");\nif (!root || !payloadNode?.textContent) throw new Error(\"Missing SSR root or payload\");\nconst payload: unknown = JSON.parse(payloadNode.textContent);\nif (typeof payload !== \"object\" || payload === null || !(\"props\" in payload) || !(\"state\" in payload)) throw new TypeError(\"Invalid SSR payload\");\nconst { props, state } = payload;\nif (typeof props !== \"object\" || props === null || !(\"initial\" in props) || typeof props.initial !== \"number\" || !Number.isFinite(props.initial)) throw new TypeError(\"Invalid SSR props\");\nif (typeof state !== \"object\" || state === null || !(\"count\" in state) || typeof state.count !== \"number\" || !Number.isFinite(state.count)) throw new TypeError(\"Invalid SSR state\");\nhydrate(root, { initial: props.initial }, { count: state.count } satisfies HotState);\n`,\n  \"server.mjs\": `import { createServer } from \"node:http\";\nimport { readFile } from \"node:fs/promises\";\nimport { dirname, extname, resolve, sep } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { createServer as createViteServer } from \"vite\";\n\nconst root = dirname(fileURLToPath(import.meta.url));\nconst production = process.argv.includes(\"--production\");\nconst vite = production ? undefined : await createViteServer({ root, server: { middlewareMode: true }, appType: \"custom\" });\nconst clientRoot = resolve(root, \"dist/client\");\nlet clientSource = \"/src/entry-client.ts\";\nif (production) {\n  const manifest = JSON.parse(await readFile(resolve(clientRoot, \".vite/manifest.json\"), \"utf8\"));\n  const entry = manifest[\"index.html\"];\n  if (!entry?.file) throw new Error(\"Missing Vite client entry\");\n  clientSource = \"/\" + entry.file;\n}\n\nconst contentTypes = { \".js\": \"text/javascript\", \".css\": \"text/css\", \".png\": \"image/png\", \".svg\": \"image/svg+xml\", \".ico\": \"image/x-icon\" };\nconst server = createServer(async (request, response) => {\n  try {\n    const path = new URL(request.url ?? \"/\", \"http://localhost\").pathname;\n    if (path === \"/\") {\n      const module = vite ? await vite.ssrLoadModule(\"/src/entry-server.ts\") : await import(pathToFileURL(resolve(root, \"dist/server/entry-server.js\")).href);\n      const html = module.renderPage(clientSource);\n      response.writeHead(200, { \"content-type\": \"text/html; charset=utf-8\" });\n      response.end(vite ? await vite.transformIndexHtml(path, html) : html);\n      return;\n    }\n    if (vite) {\n      vite.middlewares(request, response, () => { response.writeHead(404); response.end(); });\n      return;\n    }\n    const file = resolve(clientRoot, \".\" + path);\n    if (!file.startsWith(clientRoot + sep)) { response.writeHead(403); response.end(); return; }\n    const body = await readFile(file);\n    response.writeHead(200, { \"content-type\": contentTypes[extname(file)] ?? \"application/octet-stream\" });\n    response.end(body);\n  } catch (error) {\n    console.error(error);\n    response.writeHead(500);\n    response.end(\"Internal server error\");\n  }\n});\n\nconst port = Number(process.env.PORT ?? 4173);\nserver.listen(port, \"127.0.0.1\", () => console.log(\"http://127.0.0.1:\" + port));\nlet shutdownPromise;\nconst closeServer = () => new Promise((resolveClose, rejectClose) => {\n  server.close((error) => error ? rejectClose(error) : resolveClose());\n});\nasync function shutdown() {\n  if (shutdownPromise) return shutdownPromise;\n  shutdownPromise = (async () => {\n    const results = await Promise.allSettled([\n      closeServer(),\n      vite?.close() ?? Promise.resolve(),\n    ]);\n    const failures = results.flatMap((result) => result.status === \"rejected\" ? [result.reason] : []);\n    if (failures.length === 1) throw failures[0];\n    if (failures.length > 1) throw new AggregateError(failures, \"Meeko server shutdown failed\");\n  })();\n  return shutdownPromise;\n}\nconst onSignal = () => {\n  process.off(\"SIGINT\", onSignal);\n  process.off(\"SIGTERM\", onSignal);\n  void shutdown().catch((error) => {\n    try { console.error(\"Meeko server shutdown failed\", error); }\n    finally { process.exitCode = 1; }\n  });\n};\nprocess.once(\"SIGINT\", onSignal);\nprocess.once(\"SIGTERM\", onSignal);\n`,\n  \"README.md\": `# Meeko SSR starter\n\nProyecto inicial con renderizado en servidor e hidratación del mismo componente \\`.meeko\\`.\n\n\\`\\`\\`sh\nnpm install\nnpm run dev\n\\`\\`\\`\n\nAbre http://127.0.0.1:4173. El servidor produce HTML y transfiere las props y señales al navegador.\n\n\\`npm run check\\` genera los tipos del componente y comprueba TypeScript. \\`npm run build\\` compila cliente y servidor; \\`npm start\\` sirve ambas compilaciones con SSR.\n`,\n};\n\n/** Crea un proyecto SSR independiente sin sobrescribir archivos del usuario. */\nexport async function initProject(directory: string): Promise<string> {\n  const target = resolve(directory);\n  const name = basename(target).toLowerCase().replace(/[^a-z0-9._-]+/g, \"-\").replace(/^[._-]+|[._-]+$/g, \"\") || \"meeko-app\";\n  const packageMetadata: unknown = JSON.parse(await readFile(new URL(\"../package.json\", import.meta.url), \"utf8\"));\n  if (typeof packageMetadata !== \"object\" || packageMetadata === null || !(\"version\" in packageMetadata) || typeof packageMetadata.version !== \"string\") {\n    throw new Error(\"Meeko package version is unavailable\");\n  }\n  let existingEntries: string[] = [];\n  try {\n    if (!(await stat(target)).isDirectory()) throw new Error(`Destination is not a directory: ${target}`);\n    existingEntries = await readdir(target);\n  } catch (error) {\n    if (!(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")) throw error;\n  }\n  const unexpected = existingEntries.filter((entry) => !packageScaffoldEntries.has(entry));\n  if (unexpected.length > 0 || (existingEntries.length > 0 && !existingEntries.includes(\"package.json\"))) {\n    throw new Error(`Destination is not empty: ${target}${unexpected.length > 0 ? ` (${unexpected.join(\", \")})` : \"\"}`);\n  }\n  const existing: unknown = existingEntries.includes(\"package.json\") ? JSON.parse(await readFile(join(target, \"package.json\"), \"utf8\")) : {};\n  if (!isRecord(existing)) throw new Error(`Invalid package.json in ${target}`);\n  const existingScripts = existing.scripts ?? {};\n  const existingDependencies = existing.dependencies ?? {};\n  const existingDevDependencies = existing.devDependencies ?? {};\n  const existingEngines = existing.engines ?? {};\n  if (!isRecord(existingScripts) || !isRecord(existingDependencies) || !isRecord(existingDevDependencies) || !isRecord(existingEngines)) {\n    throw new Error(`Invalid package.json in ${target}`);\n  }\n  const scripts = {\n    dev: \"node server.mjs\",\n    check: \"meeko types src/App.meeko && tsc --noEmit\",\n    build: \"npm run check && vite build --outDir dist/client --manifest && vite build --ssr src/entry-server.ts --outDir dist/server\",\n    start: \"node server.mjs --production\",\n  };\n  const devDependencies = { \"@types/node\": \"^24.0.0\", typescript: \"^7.0.2\", vite: \"^8.3.5\" };\n  for (const command of Object.keys(scripts)) {\n    if (command in existingScripts) throw new Error(`Destination already defines the ${command} script: ${target}`);\n  }\n  if (Object.keys(existingDependencies).some((dependency) => dependency !== \"@meekojs/meeko\") || Object.keys(existingDevDependencies).some((dependency) => !(dependency in devDependencies))) {\n    throw new Error(`Destination contains other dependencies: ${target}`);\n  }\n  const packageFile = JSON.stringify({\n    ...existing,\n    name: typeof existing.name === \"string\" ? existing.name : name,\n    private: true,\n    type: \"module\",\n    engines: { ...existingEngines, node: \">=24\" },\n    scripts: { ...existingScripts, ...scripts },\n    dependencies: { ...existingDependencies, \"@meekojs/meeko\": packageMetadata.version },\n    devDependencies: { ...existingDevDependencies, ...devDependencies },\n  }, null, 2) + \"\\n\";\n  await mkdir(target, { recursive: true });\n  for (const [filename, content] of Object.entries(starterFiles)) {\n    const path = join(target, filename);\n    await mkdir(dirname(path), { recursive: true });\n    await writeFile(path, content, { encoding: \"utf8\", flag: \"wx\" });\n  }\n  await writeFile(join(target, \"package.json\"), packageFile, { encoding: \"utf8\", flag: existingEntries.includes(\"package.json\") ? \"w\" : \"wx\" });\n  return target;\n}\n"]}

package/dist/internal.d.ts

@@ -4,9 +4,9 @@
  * Esta ruta es interna y puede cambiar junto con el compilador. Las aplicaciones
  * deben importar las API documentadas desde la raíz del paquete.
  */
-export { createRoot } from "./reactivity.js";
+export { createRoot, finishWithCleanup } from "./reactivity.js";
 export { attributeValue, escapeHtml, renderAttribute, serializeJson } from "./server.js";
-export { bindAttribute, bindComponent, bindEvent, bindFor, bindIf, bindText, keyToken, renderComponent, renderFor, renderIf, withStateSnapshot } from "./dom.js";
+export { bindAttribute, bindComponent, bindEvent, bindFor, bindIf, bindText, keyToken, releaseAll, renderComponent, renderFor, renderIf, withStateSnapshot } from "./dom.js";
 export type { ComponentModule, ComponentRelease, DomScope } from "./dom.js";
 export { enableHotModule, registerHotInstance, registerHotScope, replaceHotModule, replaceHotStyle, restoreSignals, snapshotSignals } from "./hmr.js";
 export type { HotComponent, HotState } from "./hmr.js";

package/dist/internal.js

@@ -4,9 +4,9 @@
  * Esta ruta es interna y puede cambiar junto con el compilador. Las aplicaciones
  * deben importar las API documentadas desde la raíz del paquete.
  */
-export { createRoot } from "./reactivity.js";
+export { createRoot, finishWithCleanup } from "./reactivity.js";
 export { attributeValue, escapeHtml, renderAttribute, serializeJson } from "./server.js";
-export { bindAttribute, bindComponent, bindEvent, bindFor, bindIf, bindText, keyToken, renderComponent, renderFor, renderIf, withStateSnapshot } from "./dom.js";
+export { bindAttribute, bindComponent, bindEvent, bindFor, bindIf, bindText, keyToken, releaseAll, renderComponent, renderFor, renderIf, withStateSnapshot } from "./dom.js";
 export { enableHotModule, registerHotInstance, registerHotScope, replaceHotModule, replaceHotStyle, restoreSignals, snapshotSignals } from "./hmr.js";
 export { registerDevtoolsInstance } from "./devtools.js";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEjK,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEtJ,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/**\n * Contrato del runtime generado por el compilador Meeko.\n *\n * Esta ruta es interna y puede cambiar junto con el compilador. Las aplicaciones\n * deben importar las API documentadas desde la raíz del paquete.\n */\nexport { createRoot } from \"./reactivity.js\";\nexport { attributeValue, escapeHtml, renderAttribute, serializeJson } from \"./server.js\";\nexport { bindAttribute, bindComponent, bindEvent, bindFor, bindIf, bindText, keyToken, renderComponent, renderFor, renderIf, withStateSnapshot } from \"./dom.js\";\nexport type { ComponentModule, ComponentRelease, DomScope } from \"./dom.js\";\nexport { enableHotModule, registerHotInstance, registerHotScope, replaceHotModule, replaceHotStyle, restoreSignals, snapshotSignals } from \"./hmr.js\";\nexport type { HotComponent, HotState } from \"./hmr.js\";\nexport { registerDevtoolsInstance } from \"./devtools.js\";\n"]}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7K,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEtJ,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/**\n * Contrato del runtime generado por el compilador Meeko.\n *\n * Esta ruta es interna y puede cambiar junto con el compilador. Las aplicaciones\n * deben importar las API documentadas desde la raíz del paquete.\n */\nexport { createRoot, finishWithCleanup } from \"./reactivity.js\";\nexport { attributeValue, escapeHtml, renderAttribute, serializeJson } from \"./server.js\";\nexport { bindAttribute, bindComponent, bindEvent, bindFor, bindIf, bindText, keyToken, releaseAll, renderComponent, renderFor, renderIf, withStateSnapshot } from \"./dom.js\";\nexport type { ComponentModule, ComponentRelease, DomScope } from \"./dom.js\";\nexport { enableHotModule, registerHotInstance, registerHotScope, replaceHotModule, replaceHotStyle, restoreSignals, snapshotSignals } from \"./hmr.js\";\nexport type { HotComponent, HotState } from \"./hmr.js\";\nexport { registerDevtoolsInstance } from \"./devtools.js\";\n"]}

package/dist/node.d.ts

@@ -8,5 +8,9 @@ export type { RouteLayer, RouteModule, ComposeRoutesOptions } from "./framework/
 export { prerenderRoutes, prerenderProject } from "./framework/prerender.js";
 export type { PrerenderOptions } from "./framework/prerender.js";
 export * from "./framework-server.js";
+export interface NodeListenerOptions {
+    /** Receives uncaught handler or response-stream failures with a correlation ID. */
+    onError?: (error: unknown, requestId: string) => void;
+}
 /** Adapts a portable Fetch handler to Node 24's HTTP server callback. */
-export declare function toNodeListener(handler: (request: Request) => Promise<Response> | Response): (request: IncomingMessage, response: ServerResponse) => void;
+export declare function toNodeListener(handler: (request: Request) => Promise<Response> | Response, options?: NodeListenerOptions): (request: IncomingMessage, response: ServerResponse) => void;

package/dist/node.js

@@ -1,13 +1,24 @@
+import { randomUUID } from "node:crypto";
 import { Readable } from "node:stream";
 import { TLSSocket } from "node:tls";
+import { ApiError, errorResponse, observeServerError } from "./framework-server/contracts.js";
 export { discoverRoutes, createFrameworkHandler } from "./framework/server.js";
 export { composeFrameworkRoutes } from "./framework/modules.js";
 export { discoverConfiguredRoutes, loadMeekoConfig, resolveConfigSources, readMeekoConfigSync } from "./framework/config.js";
 export { prerenderRoutes, prerenderProject } from "./framework/prerender.js";
 export * from "./framework-server.js";
+function nodeResponseHeaders(headers) {
+    const result = {};
+    headers.forEach((value, name) => { result[name] = value; });
+    const cookies = headers.getSetCookie();
+    if (cookies.length)
+        result["set-cookie"] = cookies;
+    return result;
+}
 /** Adapts a portable Fetch handler to Node 24's HTTP server callback. */
-export function toNodeListener(handler) {
+export function toNodeListener(handler, options = {}) {
     return (incoming, outgoing) => {
+        let responseRequestId;
         void (async () => {
             const controller = new AbortController();
             const abort = () => controller.abort();
@@ -16,7 +27,13 @@ export function toNodeListener(handler) {
             try {
                 const authority = incoming.headers.host ?? "localhost";
                 const protocol = incoming.socket instanceof TLSSocket ? "https" : "http";
-                const url = new URL(incoming.url ?? "/", `${protocol}://${authority}`);
+                let url;
+                try {
+                    url = new URL(incoming.url ?? "/", `${protocol}://${authority}`);
+                }
+                catch {
+                    throw new ApiError("INVALID_URL", 400);
+                }
                 const method = incoming.method ?? "GET";
                 const headers = new Headers();
                 for (const [name, value] of Object.entries(incoming.headers)) {
@@ -29,23 +46,76 @@ export function toNodeListener(handler) {
                     ...(hasBody ? { body: Readable.toWeb(incoming), duplex: "half" } : {}),
                 });
                 const result = await handler(request);
-                outgoing.writeHead(result.status, Object.fromEntries(result.headers));
+                const candidateRequestId = result.headers.get("x-request-id");
+                if (candidateRequestId && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(candidateRequestId)) {
+                    responseRequestId = candidateRequestId;
+                }
+                if (controller.signal.aborted || outgoing.destroyed)
+                    return;
+                outgoing.writeHead(result.status, nodeResponseHeaders(result.headers));
                 if (method === "HEAD" || !result.body) {
                     outgoing.end();
                     return;
                 }
-                for await (const chunk of result.body)
-                    outgoing.write(chunk);
-                outgoing.end();
+                const reader = result.body.getReader();
+                try {
+                    while (true) {
+                        if (controller.signal.aborted || outgoing.destroyed) {
+                            await reader.cancel();
+                            return;
+                        }
+                        const chunk = await reader.read();
+                        if (chunk.done)
+                            break;
+                        if (controller.signal.aborted || outgoing.destroyed) {
+                            await reader.cancel();
+                            return;
+                        }
+                        outgoing.write(chunk.value);
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+                if (!controller.signal.aborted && !outgoing.destroyed)
+                    outgoing.end();
             }
             finally {
                 incoming.off("aborted", abort);
                 outgoing.off("close", abort);
             }
-        })().catch(() => {
-            if (!outgoing.headersSent)
-                outgoing.writeHead(500, { "content-type": "text/plain; charset=utf-8" });
-            outgoing.end("Internal server error");
+        })().catch(async (error) => {
+            const requestId = responseRequestId ?? randomUUID();
+            observeServerError(error, requestId, options.onError);
+            if (outgoing.destroyed)
+                return;
+            const reportSecondary = (failure) => {
+                if (!Object.is(failure, error))
+                    observeServerError(failure, requestId, options.onError);
+            };
+            const destroySafely = (cause) => {
+                try {
+                    outgoing.destroy(cause instanceof Error ? cause : undefined);
+                }
+                catch (destroyError) {
+                    if (!Object.is(destroyError, error) && !Object.is(destroyError, cause)) {
+                        observeServerError(destroyError, requestId, options.onError);
+                    }
+                }
+            };
+            if (outgoing.headersSent) {
+                destroySafely(error);
+                return;
+            }
+            try {
+                const failure = errorResponse(error, requestId);
+                outgoing.writeHead(failure.status, nodeResponseHeaders(failure.headers));
+                outgoing.end(incoming.method === "HEAD" ? undefined : await failure.text());
+            }
+            catch (failure) {
+                reportSecondary(failure);
+                destroySafely(failure);
+            }
         });
     };
 }

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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","sourcesContent":["import { Readable } from \"node:stream\";\nimport { TLSSocket } from \"node:tls\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\nexport { discoverRoutes, createFrameworkHandler } from \"./framework/server.js\";\nexport type { FrameworkHandlerOptions, PageModule, PageRoute, PageRequestContext } from \"./framework/server.js\";\nexport { composeFrameworkRoutes } from \"./framework/modules.js\";\nexport { discoverConfiguredRoutes, loadMeekoConfig, resolveConfigSources, readMeekoConfigSync } from \"./framework/config.js\";\nexport type { MeekoConfig, ConfigSource } from \"./framework/config.js\";\nexport type { RouteLayer, RouteModule, ComposeRoutesOptions } from \"./framework/modules.js\";\nexport { prerenderRoutes, prerenderProject } from \"./framework/prerender.js\";\nexport type { PrerenderOptions } from \"./framework/prerender.js\";\nexport * from \"./framework-server.js\";\n\n/** Adapts a portable Fetch handler to Node 24's HTTP server callback. */\nexport function toNodeListener(handler: (request: Request) => Promise<Response> | Response): (request: IncomingMessage, response: ServerResponse) => void {\n  return (incoming, outgoing) => {\n    void (async () => {\n      const controller = new AbortController();\n      const abort = () => controller.abort();\n      incoming.once(\"aborted\", abort);\n      outgoing.once(\"close\", abort);\n      try {\n      const authority = incoming.headers.host ?? \"localhost\";\n      const protocol = incoming.socket instanceof TLSSocket ? \"https\" : \"http\";\n      const url = new URL(incoming.url ?? \"/\", `${protocol}://${authority}`);\n      const method = incoming.method ?? \"GET\";\n      const headers = new Headers();\n      for (const [name, value] of Object.entries(incoming.headers)) {\n        if (value !== undefined) headers.set(name, Array.isArray(value) ? value.join(\", \") : value);\n      }\n      const hasBody = method !== \"GET\" && method !== \"HEAD\";\n      const request = new Request(url, {\n        method, headers, signal: controller.signal,\n        ...(hasBody ? { body: Readable.toWeb(incoming) as ReadableStream<Uint8Array>, duplex: \"half\" as const } : {}),\n      });\n      const result = await handler(request);\n      outgoing.writeHead(result.status, Object.fromEntries(result.headers));\n      if (method === \"HEAD\" || !result.body) { outgoing.end(); return; }\n      for await (const chunk of result.body) outgoing.write(chunk);\n      outgoing.end();\n      } finally {\n        incoming.off(\"aborted\", abort);\n        outgoing.off(\"close\", abort);\n      }\n    })().catch(() => {\n      if (!outgoing.headersSent) outgoing.writeHead(500, { \"content-type\": \"text/plain; charset=utf-8\" });\n      outgoing.end(\"Internal server error\");\n    });\n  };\n}\n"]}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { Readable } from \"node:stream\";\nimport { TLSSocket } from \"node:tls\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { ApiError, errorResponse, observeServerError } from \"./framework-server/contracts.js\";\n\nexport { discoverRoutes, createFrameworkHandler } from \"./framework/server.js\";\nexport type { FrameworkHandlerOptions, PageModule, PageRoute, PageRequestContext } from \"./framework/server.js\";\nexport { composeFrameworkRoutes } from \"./framework/modules.js\";\nexport { discoverConfiguredRoutes, loadMeekoConfig, resolveConfigSources, readMeekoConfigSync } from \"./framework/config.js\";\nexport type { MeekoConfig, ConfigSource } from \"./framework/config.js\";\nexport type { RouteLayer, RouteModule, ComposeRoutesOptions } from \"./framework/modules.js\";\nexport { prerenderRoutes, prerenderProject } from \"./framework/prerender.js\";\nexport type { PrerenderOptions } from \"./framework/prerender.js\";\nexport * from \"./framework-server.js\";\n\nexport interface NodeListenerOptions {\n  /** Receives uncaught handler or response-stream failures with a correlation ID. */\n  onError?: (error: unknown, requestId: string) => void;\n}\n\nfunction nodeResponseHeaders(headers: Headers): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n  headers.forEach((value, name) => { result[name] = value; });\n  const cookies = headers.getSetCookie();\n  if (cookies.length) result[\"set-cookie\"] = cookies;\n  return result;\n}\n\n/** Adapts a portable Fetch handler to Node 24's HTTP server callback. */\nexport function toNodeListener(handler: (request: Request) => Promise<Response> | Response, options: NodeListenerOptions = {}): (request: IncomingMessage, response: ServerResponse) => void {\n  return (incoming, outgoing) => {\n    let responseRequestId: string | undefined;\n    void (async () => {\n      const controller = new AbortController();\n      const abort = () => controller.abort();\n      incoming.once(\"aborted\", abort);\n      outgoing.once(\"close\", abort);\n      try {\n      const authority = incoming.headers.host ?? \"localhost\";\n      const protocol = incoming.socket instanceof TLSSocket ? \"https\" : \"http\";\n      let url: URL;\n      try { url = new URL(incoming.url ?? \"/\", `${protocol}://${authority}`); }\n      catch { throw new ApiError(\"INVALID_URL\", 400); }\n      const method = incoming.method ?? \"GET\";\n      const headers = new Headers();\n      for (const [name, value] of Object.entries(incoming.headers)) {\n        if (value !== undefined) headers.set(name, Array.isArray(value) ? value.join(\", \") : value);\n      }\n      const hasBody = method !== \"GET\" && method !== \"HEAD\";\n      const request = new Request(url, {\n        method, headers, signal: controller.signal,\n        ...(hasBody ? { body: Readable.toWeb(incoming) as ReadableStream<Uint8Array>, duplex: \"half\" as const } : {}),\n      });\n      const result = await handler(request);\n      const candidateRequestId = result.headers.get(\"x-request-id\");\n      if (candidateRequestId && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(candidateRequestId)) {\n        responseRequestId = candidateRequestId;\n      }\n      if (controller.signal.aborted || outgoing.destroyed) return;\n      outgoing.writeHead(result.status, nodeResponseHeaders(result.headers));\n      if (method === \"HEAD\" || !result.body) { outgoing.end(); return; }\n      const reader = result.body.getReader();\n      try {\n        while (true) {\n          if (controller.signal.aborted || outgoing.destroyed) { await reader.cancel(); return; }\n          const chunk = await reader.read();\n          if (chunk.done) break;\n          if (controller.signal.aborted || outgoing.destroyed) { await reader.cancel(); return; }\n          outgoing.write(chunk.value);\n        }\n      } finally { reader.releaseLock(); }\n      if (!controller.signal.aborted && !outgoing.destroyed) outgoing.end();\n      } finally {\n        incoming.off(\"aborted\", abort);\n        outgoing.off(\"close\", abort);\n      }\n    })().catch(async (error: unknown) => {\n      const requestId = responseRequestId ?? randomUUID();\n      observeServerError(error, requestId, options.onError);\n      if (outgoing.destroyed) return;\n      const reportSecondary = (failure: unknown): void => {\n        if (!Object.is(failure, error)) observeServerError(failure, requestId, options.onError);\n      };\n      const destroySafely = (cause: unknown): void => {\n        try { outgoing.destroy(cause instanceof Error ? cause : undefined); }\n        catch (destroyError) {\n          if (!Object.is(destroyError, error) && !Object.is(destroyError, cause)) {\n            observeServerError(destroyError, requestId, options.onError);\n          }\n        }\n      };\n      if (outgoing.headersSent) { destroySafely(error); return; }\n      try {\n        const failure = errorResponse(error, requestId);\n        outgoing.writeHead(failure.status, nodeResponseHeaders(failure.headers));\n        outgoing.end(incoming.method === \"HEAD\" ? undefined : await failure.text());\n      } catch (failure) {\n        reportSecondary(failure);\n        destroySafely(failure);\n      }\n    });\n  };\n}\n"]}

package/dist/reactivity.d.ts

@@ -26,14 +26,20 @@ export declare function isWritableSignal(value: unknown): value is Signal<unknow
 export declare function provide<T>(key: ContextKey<T>, value: T): void;
 /** Lee el proveedor más cercano; falla si falta para evitar un valor implícito. */
 export declare function inject<T>(key: ContextKey<T>): T;
-/** Registers an external resource to be released with the current component root. */
-export declare function onCleanup(release: () => void): void;
+/** Looks up optional context without creating a process-wide fallback. */
+export declare function findContext<T>(key: ContextKey<T>): T | undefined;
+type SyncCleanupCallback<F extends () => unknown> = [Extract<ReturnType<F>, PromiseLike<unknown>>] extends [never] ? F : never;
+/** Registers a synchronous external-resource release with the current component root. */
+export declare function onCleanup<const F extends () => unknown>(release: SyncCleanupCallback<F>): void;
 /** Crea un valor observable. Las escrituras iguales no notifican cambios. */
 export declare function signal<T>(initial: T): Signal<T>;
 /** Ejecuta una función cuando cambian las señales leídas por ella. */
-export declare function effect(fn: () => void, source?: EffectSource): () => void;
+type SyncEffectCallback<F extends () => unknown> = [Extract<ReturnType<F>, PromiseLike<unknown>>] extends [never] ? F : never;
+export declare function effect<const F extends () => unknown>(fn: SyncEffectCallback<F>, source?: EffectSource): () => void;
 /** Identidad opaca de la raíz reactiva activa; permite aislar instancias anidadas. */
 export declare function currentEffectOwner(): object | undefined;
+/** Captures the parent of a component root for a later HMR replacement. */
+export declare function captureParentOwner(): <T>(work: () => T) => T;
 /** Devuelve expresiones de plantilla actualmente dependientes de una señal en una raíz. */
 export declare function signalReadSites(value: Signal<unknown>, owner: object | undefined): EffectSource[];
 /** Deriva un valor de otras señales y lo actualiza cuando cambian. */
@@ -44,3 +50,6 @@ export declare function batch<T>(fn: () => T): T;
 export declare function untrack<T>(fn: () => T): T;
 /** Asocia efectos a una instancia y entrega una función para liberarlos. */
 export declare function createRoot<T>(fn: (dispose: () => void) => T): T;
+/** Runs cleanup on either outcome without losing an earlier failure. */
+export declare function finishWithCleanup<T>(work: () => T, cleanup: () => void): T;
+export {};

package/dist/reactivity.js

@@ -1,3 +1,4 @@
+import { logClientError, observeReturnedPromise } from "./error-observer.js";
 /** Crea una clave única; el tipo no se infiere de un valor global compartido. */
 export function createContext(description) {
     return Symbol(description);
@@ -28,7 +29,15 @@ export function inject(key) {
     }
     throw new Error(`Missing Meeko context${key.description ? `: ${key.description}` : ""}`);
 }
-/** Registers an external resource to be released with the current component root. */
+/** Looks up optional context without creating a process-wide fallback. */
+export function findContext(key) {
+    for (let owner = activeOwner; owner; owner = owner.parent) {
+        if (owner.context.has(key))
+            return owner.context.get(key);
+    }
+    return undefined;
+}
+/** Registers a synchronous external-resource release with the current component root. */
 export function onCleanup(release) {
     if (!activeOwner)
         throw new Error("onCleanup() requires an active component root");
@@ -43,21 +52,36 @@ function flush() {
     if (flushing || batchDepth > 0)
         return;
     flushing = true;
+    const failures = [];
     try {
         let iterations = 0;
         while (pending.size > 0) {
-            if (++iterations > 1000)
-                throw new Error("Reactive update cycle exceeded 1000 iterations");
+            if (++iterations > 1000) {
+                pending.clear();
+                failures.push(new Error("Reactive update cycle exceeded 1000 iterations"));
+                break;
+            }
             const observers = [...pending];
             pending.clear();
-            for (const observer of observers)
-                if (!observer.disposed)
+            for (const observer of observers) {
+                if (observer.disposed)
+                    continue;
+                try {
                     observer.run();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
         }
     }
     finally {
         flushing = false;
     }
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, "Meeko reactive observers failed");
 }
 /** Crea un valor observable. Las escrituras iguales no notifican cambios. */
 export function signal(initial) {
@@ -84,7 +108,6 @@ export function signal(initial) {
     writableSignals.add(result);
     return result;
 }
-/** Ejecuta una función cuando cambian las señales leídas por ella. */
 export function effect(fn, source) {
     const owner = activeOwner;
     const observer = {
@@ -97,7 +120,11 @@ export function effect(fn, source) {
             activeObserver = observer;
             activeOwner = owner;
             try {
-                fn();
+                const result = fn();
+                if (observeReturnedPromise(result, (error) => logClientError("Meeko asynchronous effect rejected", error))) {
+                    stop();
+                    throw new TypeError("Meeko effect callbacks must be synchronous");
+                }
             }
             finally {
                 activeObserver = previous;
@@ -108,18 +135,39 @@ export function effect(fn, source) {
     if (source)
         effectSources.set(observer, { owner, source });
     owner?.observers.add(observer);
-    observer.run();
-    return () => {
+    function stop() {
         observer.disposed = true;
         pending.delete(observer);
         detach(observer);
         owner?.observers.delete(observer);
-    };
+    }
+    try {
+        observer.run();
+    }
+    catch (error) {
+        stop();
+        throw error;
+    }
+    return stop;
 }
 /** Identidad opaca de la raíz reactiva activa; permite aislar instancias anidadas. */
 export function currentEffectOwner() {
     return activeOwner;
 }
+/** Captures the parent of a component root for a later HMR replacement. */
+export function captureParentOwner() {
+    const parent = activeOwner?.parent;
+    return (work) => {
+        const previous = activeOwner;
+        activeOwner = parent;
+        try {
+            return work();
+        }
+        finally {
+            activeOwner = previous;
+        }
+    };
+}
 /** Devuelve expresiones de plantilla actualmente dependientes de una señal en una raíz. */
 export function signalReadSites(value, owner) {
     if (!owner || !isWritableSignal(value))
@@ -147,13 +195,10 @@ export function computed(fn) {
 /** Agrupa varias escrituras en una sola ronda de notificaciones. */
 export function batch(fn) {
     batchDepth++;
-    try {
-        return fn();
-    }
-    finally {
+    return finishWithCleanup(fn, () => {
         batchDepth--;
         flush();
-    }
+    });
 }
 /** Lee señales sin registrar dependencias en el observador activo. */
 export function untrack(fn) {
@@ -175,7 +220,10 @@ export function createRoot(fn) {
         const failures = [];
         for (const child of [...owner.children]) {
             try {
-                child();
+                const result = child();
+                if (observeReturnedPromise(result, (error) => logClientError("Meeko asynchronous cleanup rejected", error))) {
+                    failures.push(new TypeError("Meeko cleanup callbacks must be synchronous"));
+                }
             }
             catch (error) {
                 failures.push(error);
@@ -200,11 +248,40 @@ export function createRoot(fn) {
         return fn(dispose);
     }
     catch (error) {
-        dispose();
+        try {
+            dispose();
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], "Meeko root setup and cleanup failed");
+        }
         throw error;
     }
     finally {
         activeOwner = previous;
     }
 }
+/** Runs cleanup on either outcome without losing an earlier failure. */
+export function finishWithCleanup(work, cleanup) {
+    let failed = false;
+    let failure;
+    let value;
+    try {
+        value = work();
+    }
+    catch (error) {
+        failed = true;
+        failure = error;
+    }
+    try {
+        cleanup();
+    }
+    catch (error) {
+        if (failed)
+            throw new AggregateError([failure, error], "Meeko work and cleanup failed");
+        throw error;
+    }
+    if (failed)
+        throw failure;
+    return value;
+}
 //# sourceMappingURL=reactivity.js.map

package/dist/reactivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactivity.js","sourceRoot":"","sources":["../src/reactivity.ts"],"names":[],"mappings":"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","sourcesContent":["/** Señal de solo lectura que registra dependencias al consultar su valor. */\nexport interface ReadonlySignal<T> {\n  readonly value: T;\n}\n\n/** Señal cuyo valor puede actualizarse de forma reactiva. */\nexport interface Signal<T> extends ReadonlySignal<T> {\n  value: T;\n}\n\n/** Clave nominal para compartir un valor tipado entre instancias anidadas. */\nexport type ContextKey<T> = symbol & { readonly __meekoValue?: (value: T) => T };\n\n/** Crea una clave única; el tipo no se infiere de un valor global compartido. */\nexport function createContext<T>(description?: string): ContextKey<T> {\n  return Symbol(description) as ContextKey<T>;\n}\n\n/** Ubicación de una expresión de plantilla que lee una señal durante desarrollo. */\nexport interface EffectSource {\n  file: string;\n  line: number;\n  column: number;\n  expression: string;\n  kind: \"text\" | \"attribute\";\n}\n\ninterface Observer {\n  run: () => void;\n  dependencies: Set<InternalSignal<unknown>>;\n  disposed: boolean;\n}\n\ninterface Owner {\n  observers: Set<Observer>;\n  children: Set<() => void>;\n  parent: Owner | undefined;\n  context: Map<symbol, unknown>;\n}\n\ninterface InternalSignal<T> extends Signal<T> {\n  subscribers: Set<Observer> | undefined;\n}\n\nconst writableSignals = new WeakSet<object>();\nconst derivedSignals = new WeakSet<object>();\nconst effectSources = new WeakMap<Observer, { owner: Owner | undefined; source: EffectSource }>();\n\n/** Identifica señales editables creadas por Meeko para conservarlas durante HMR. */\nexport function isWritableSignal(value: unknown): value is Signal<unknown> {\n  return typeof value === \"object\" && value !== null && writableSignals.has(value) && !derivedSignals.has(value);\n}\n\nlet activeObserver: Observer | undefined;\nlet activeOwner: Owner | undefined;\nlet batchDepth = 0;\nlet flushing = false;\nconst pending = new Set<Observer>();\n\n/** Publica un valor en la instancia activa y sus descendientes. */\nexport function provide<T>(key: ContextKey<T>, value: T): void {\n  if (!activeOwner) throw new Error(\"provide() requires an active component root\");\n  activeOwner.context.set(key, value);\n}\n\n/** Lee el proveedor más cercano; falla si falta para evitar un valor implícito. */\nexport function inject<T>(key: ContextKey<T>): T {\n  for (let owner = activeOwner; owner; owner = owner.parent) {\n    if (owner.context.has(key)) return owner.context.get(key) as T;\n  }\n  throw new Error(`Missing Meeko context${key.description ? `: ${key.description}` : \"\"}`);\n}\n\n/** Registers an external resource to be released with the current component root. */\nexport function onCleanup(release: () => void): void {\n  if (!activeOwner) throw new Error(\"onCleanup() requires an active component root\");\n  activeOwner.children.add(release);\n}\n\nfunction detach(observer: Observer): void {\n  for (const dependency of observer.dependencies) dependency.subscribers?.delete(observer);\n  observer.dependencies.clear();\n}\n\nfunction flush(): void {\n  if (flushing || batchDepth > 0) return;\n  flushing = true;\n  try {\n    let iterations = 0;\n    while (pending.size > 0) {\n      if (++iterations > 1000) throw new Error(\"Reactive update cycle exceeded 1000 iterations\");\n      const observers = [...pending];\n      pending.clear();\n      for (const observer of observers) if (!observer.disposed) observer.run();\n    }\n  } finally {\n    flushing = false;\n  }\n}\n\n/** Crea un valor observable. Las escrituras iguales no notifican cambios. */\nexport function signal<T>(initial: T): Signal<T> {\n  let current = initial;\n  const result: InternalSignal<T> = {\n    subscribers: undefined,\n    get value() {\n      if (activeObserver) {\n        (result.subscribers ??= new Set()).add(activeObserver);\n        activeObserver.dependencies.add(result as InternalSignal<unknown>);\n      }\n      return current;\n    },\n    set value(next: T) {\n      if (Object.is(current, next)) return;\n      current = next;\n      if (result.subscribers) for (const observer of result.subscribers) pending.add(observer);\n      flush();\n    },\n  };\n  writableSignals.add(result);\n  return result;\n}\n\n/** Ejecuta una función cuando cambian las señales leídas por ella. */\nexport function effect(fn: () => void, source?: EffectSource): () => void {\n  const owner = activeOwner;\n  const observer: Observer = {\n    dependencies: new Set(),\n    disposed: false,\n    run() {\n      detach(observer);\n      const previous = activeObserver;\n      const previousOwner = activeOwner;\n      activeObserver = observer;\n      activeOwner = owner;\n      try {\n        fn();\n      } finally {\n        activeObserver = previous;\n        activeOwner = previousOwner;\n      }\n    },\n  };\n  if (source) effectSources.set(observer, { owner, source });\n  owner?.observers.add(observer);\n  observer.run();\n  return () => {\n    observer.disposed = true;\n    pending.delete(observer);\n    detach(observer);\n    owner?.observers.delete(observer);\n  };\n}\n\n/** Identidad opaca de la raíz reactiva activa; permite aislar instancias anidadas. */\nexport function currentEffectOwner(): object | undefined {\n  return activeOwner;\n}\n\n/** Devuelve expresiones de plantilla actualmente dependientes de una señal en una raíz. */\nexport function signalReadSites(value: Signal<unknown>, owner: object | undefined): EffectSource[] {\n  if (!owner || !isWritableSignal(value)) return [];\n  const sites = new Map<string, EffectSource>();\n  for (const observer of (value as InternalSignal<unknown>).subscribers ?? []) {\n    const metadata = effectSources.get(observer);\n    if (observer.disposed || metadata?.owner !== owner || !metadata) continue;\n    const source = metadata.source;\n    const key = `${source.file}\\u0000${source.line}\\u0000${source.column}\\u0000${source.kind}\\u0000${source.expression}`;\n    sites.set(key, source);\n  }\n  return [...sites.values()];\n}\n\n/** Deriva un valor de otras señales y lo actualiza cuando cambian. */\nexport function computed<T>(fn: () => T): ReadonlySignal<T> {\n  const result = signal<T>(undefined as T);\n  derivedSignals.add(result);\n  effect(() => {\n    result.value = fn();\n  });\n  return result;\n}\n\n/** Agrupa varias escrituras en una sola ronda de notificaciones. */\nexport function batch<T>(fn: () => T): T {\n  batchDepth++;\n  try {\n    return fn();\n  } finally {\n    batchDepth--;\n    flush();\n  }\n}\n\n/** Lee señales sin registrar dependencias en el observador activo. */\nexport function untrack<T>(fn: () => T): T {\n  const previous = activeObserver;\n  activeObserver = undefined;\n  try {\n    return fn();\n  } finally {\n    activeObserver = previous;\n  }\n}\n\n/** Asocia efectos a una instancia y entrega una función para liberarlos. */\nexport function createRoot<T>(fn: (dispose: () => void) => T): T {\n  const owner: Owner = { observers: new Set(), children: new Set(), parent: activeOwner, context: new Map() };\n  const previous = activeOwner;\n  activeOwner = owner;\n  const dispose = () => {\n    const failures: unknown[] = [];\n    for (const child of [...owner.children]) {\n      try { child(); } catch (error) { failures.push(error); }\n    }\n    owner.children.clear();\n    for (const observer of owner.observers) {\n      observer.disposed = true;\n      pending.delete(observer);\n      detach(observer);\n    }\n    owner.observers.clear();\n    owner.context.clear();\n    owner.parent?.children.delete(dispose);\n    if (failures.length === 1) throw failures[0];\n    if (failures.length > 1) throw new AggregateError(failures, \"Meeko root cleanup failed\");\n  };\n  owner.parent?.children.add(dispose);\n  try {\n    return fn(dispose);\n  } catch (error) {\n    dispose();\n    throw error;\n  } finally {\n    activeOwner = previous;\n  }\n}\n"]}
+{"version":3,"file":"reactivity.js","sourceRoot":"","sources":["../src/reactivity.ts"],"names":[],"mappings":"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","sourcesContent":["import { logClientError, observeReturnedPromise } from \"./error-observer.js\";\n\n/** Señal de solo lectura que registra dependencias al consultar su valor. */\nexport interface ReadonlySignal<T> {\n  readonly value: T;\n}\n\n/** Señal cuyo valor puede actualizarse de forma reactiva. */\nexport interface Signal<T> extends ReadonlySignal<T> {\n  value: T;\n}\n\n/** Clave nominal para compartir un valor tipado entre instancias anidadas. */\nexport type ContextKey<T> = symbol & { readonly __meekoValue?: (value: T) => T };\n\n/** Crea una clave única; el tipo no se infiere de un valor global compartido. */\nexport function createContext<T>(description?: string): ContextKey<T> {\n  return Symbol(description) as ContextKey<T>;\n}\n\n/** Ubicación de una expresión de plantilla que lee una señal durante desarrollo. */\nexport interface EffectSource {\n  file: string;\n  line: number;\n  column: number;\n  expression: string;\n  kind: \"text\" | \"attribute\";\n}\n\ninterface Observer {\n  run: () => void;\n  dependencies: Set<InternalSignal<unknown>>;\n  disposed: boolean;\n}\n\ninterface Owner {\n  observers: Set<Observer>;\n  children: Set<() => unknown>;\n  parent: Owner | undefined;\n  context: Map<symbol, unknown>;\n}\n\ninterface InternalSignal<T> extends Signal<T> {\n  subscribers: Set<Observer> | undefined;\n}\n\nconst writableSignals = new WeakSet<object>();\nconst derivedSignals = new WeakSet<object>();\nconst effectSources = new WeakMap<Observer, { owner: Owner | undefined; source: EffectSource }>();\n\n/** Identifica señales editables creadas por Meeko para conservarlas durante HMR. */\nexport function isWritableSignal(value: unknown): value is Signal<unknown> {\n  return typeof value === \"object\" && value !== null && writableSignals.has(value) && !derivedSignals.has(value);\n}\n\nlet activeObserver: Observer | undefined;\nlet activeOwner: Owner | undefined;\nlet batchDepth = 0;\nlet flushing = false;\nconst pending = new Set<Observer>();\n\n/** Publica un valor en la instancia activa y sus descendientes. */\nexport function provide<T>(key: ContextKey<T>, value: T): void {\n  if (!activeOwner) throw new Error(\"provide() requires an active component root\");\n  activeOwner.context.set(key, value);\n}\n\n/** Lee el proveedor más cercano; falla si falta para evitar un valor implícito. */\nexport function inject<T>(key: ContextKey<T>): T {\n  for (let owner = activeOwner; owner; owner = owner.parent) {\n    if (owner.context.has(key)) return owner.context.get(key) as T;\n  }\n  throw new Error(`Missing Meeko context${key.description ? `: ${key.description}` : \"\"}`);\n}\n\n/** Looks up optional context without creating a process-wide fallback. */\nexport function findContext<T>(key: ContextKey<T>): T | undefined {\n  for (let owner = activeOwner; owner; owner = owner.parent) {\n    if (owner.context.has(key)) return owner.context.get(key) as T;\n  }\n  return undefined;\n}\n\ntype SyncCleanupCallback<F extends () => unknown> = [Extract<ReturnType<F>, PromiseLike<unknown>>] extends [never] ? F : never;\n\n/** Registers a synchronous external-resource release with the current component root. */\nexport function onCleanup<const F extends () => unknown>(release: SyncCleanupCallback<F>): void {\n  if (!activeOwner) throw new Error(\"onCleanup() requires an active component root\");\n  activeOwner.children.add(release);\n}\n\nfunction detach(observer: Observer): void {\n  for (const dependency of observer.dependencies) dependency.subscribers?.delete(observer);\n  observer.dependencies.clear();\n}\n\nfunction flush(): void {\n  if (flushing || batchDepth > 0) return;\n  flushing = true;\n  const failures: unknown[] = [];\n  try {\n    let iterations = 0;\n    while (pending.size > 0) {\n      if (++iterations > 1000) {\n        pending.clear();\n        failures.push(new Error(\"Reactive update cycle exceeded 1000 iterations\"));\n        break;\n      }\n      const observers = [...pending];\n      pending.clear();\n      for (const observer of observers) {\n        if (observer.disposed) continue;\n        try { observer.run(); }\n        catch (error) { failures.push(error); }\n      }\n    }\n  } finally {\n    flushing = false;\n  }\n  if (failures.length === 1) throw failures[0];\n  if (failures.length > 1) throw new AggregateError(failures, \"Meeko reactive observers failed\");\n}\n\n/** Crea un valor observable. Las escrituras iguales no notifican cambios. */\nexport function signal<T>(initial: T): Signal<T> {\n  let current = initial;\n  const result: InternalSignal<T> = {\n    subscribers: undefined,\n    get value() {\n      if (activeObserver) {\n        (result.subscribers ??= new Set()).add(activeObserver);\n        activeObserver.dependencies.add(result as InternalSignal<unknown>);\n      }\n      return current;\n    },\n    set value(next: T) {\n      if (Object.is(current, next)) return;\n      current = next;\n      if (result.subscribers) for (const observer of result.subscribers) pending.add(observer);\n      flush();\n    },\n  };\n  writableSignals.add(result);\n  return result;\n}\n\n/** Ejecuta una función cuando cambian las señales leídas por ella. */\ntype SyncEffectCallback<F extends () => unknown> = [Extract<ReturnType<F>, PromiseLike<unknown>>] extends [never] ? F : never;\n\nexport function effect<const F extends () => unknown>(fn: SyncEffectCallback<F>, source?: EffectSource): () => void {\n  const owner = activeOwner;\n  const observer: Observer = {\n    dependencies: new Set(),\n    disposed: false,\n    run() {\n      detach(observer);\n      const previous = activeObserver;\n      const previousOwner = activeOwner;\n      activeObserver = observer;\n      activeOwner = owner;\n      try {\n        const result: unknown = fn();\n        if (observeReturnedPromise(result, (error) => logClientError(\"Meeko asynchronous effect rejected\", error))) {\n          stop();\n          throw new TypeError(\"Meeko effect callbacks must be synchronous\");\n        }\n      } finally {\n        activeObserver = previous;\n        activeOwner = previousOwner;\n      }\n    },\n  };\n  if (source) effectSources.set(observer, { owner, source });\n  owner?.observers.add(observer);\n  function stop(): void {\n    observer.disposed = true;\n    pending.delete(observer);\n    detach(observer);\n    owner?.observers.delete(observer);\n  }\n  try { observer.run(); }\n  catch (error) {\n    stop();\n    throw error;\n  }\n  return stop;\n}\n\n/** Identidad opaca de la raíz reactiva activa; permite aislar instancias anidadas. */\nexport function currentEffectOwner(): object | undefined {\n  return activeOwner;\n}\n\n/** Captures the parent of a component root for a later HMR replacement. */\nexport function captureParentOwner(): <T>(work: () => T) => T {\n  const parent = activeOwner?.parent;\n  return <T>(work: () => T): T => {\n    const previous = activeOwner;\n    activeOwner = parent;\n    try { return work(); }\n    finally { activeOwner = previous; }\n  };\n}\n\n/** Devuelve expresiones de plantilla actualmente dependientes de una señal en una raíz. */\nexport function signalReadSites(value: Signal<unknown>, owner: object | undefined): EffectSource[] {\n  if (!owner || !isWritableSignal(value)) return [];\n  const sites = new Map<string, EffectSource>();\n  for (const observer of (value as InternalSignal<unknown>).subscribers ?? []) {\n    const metadata = effectSources.get(observer);\n    if (observer.disposed || metadata?.owner !== owner || !metadata) continue;\n    const source = metadata.source;\n    const key = `${source.file}\\u0000${source.line}\\u0000${source.column}\\u0000${source.kind}\\u0000${source.expression}`;\n    sites.set(key, source);\n  }\n  return [...sites.values()];\n}\n\n/** Deriva un valor de otras señales y lo actualiza cuando cambian. */\nexport function computed<T>(fn: () => T): ReadonlySignal<T> {\n  const result = signal<T>(undefined as T);\n  derivedSignals.add(result);\n  effect(() => {\n    result.value = fn();\n  });\n  return result;\n}\n\n/** Agrupa varias escrituras en una sola ronda de notificaciones. */\nexport function batch<T>(fn: () => T): T {\n  batchDepth++;\n  return finishWithCleanup(fn, () => {\n    batchDepth--;\n    flush();\n  });\n}\n\n/** Lee señales sin registrar dependencias en el observador activo. */\nexport function untrack<T>(fn: () => T): T {\n  const previous = activeObserver;\n  activeObserver = undefined;\n  try {\n    return fn();\n  } finally {\n    activeObserver = previous;\n  }\n}\n\n/** Asocia efectos a una instancia y entrega una función para liberarlos. */\nexport function createRoot<T>(fn: (dispose: () => void) => T): T {\n  const owner: Owner = { observers: new Set(), children: new Set(), parent: activeOwner, context: new Map() };\n  const previous = activeOwner;\n  activeOwner = owner;\n  const dispose = () => {\n    const failures: unknown[] = [];\n    for (const child of [...owner.children]) {\n      try {\n        const result = child();\n        if (observeReturnedPromise(result, (error) => logClientError(\"Meeko asynchronous cleanup rejected\", error))) {\n          failures.push(new TypeError(\"Meeko cleanup callbacks must be synchronous\"));\n        }\n      } catch (error) { failures.push(error); }\n    }\n    owner.children.clear();\n    for (const observer of owner.observers) {\n      observer.disposed = true;\n      pending.delete(observer);\n      detach(observer);\n    }\n    owner.observers.clear();\n    owner.context.clear();\n    owner.parent?.children.delete(dispose);\n    if (failures.length === 1) throw failures[0];\n    if (failures.length > 1) throw new AggregateError(failures, \"Meeko root cleanup failed\");\n  };\n  owner.parent?.children.add(dispose);\n  try {\n    return fn(dispose);\n  } catch (error) {\n    try { dispose(); }\n    catch (cleanupError) {\n      throw new AggregateError([error, cleanupError], \"Meeko root setup and cleanup failed\");\n    }\n    throw error;\n  } finally {\n    activeOwner = previous;\n  }\n}\n\n/** Runs cleanup on either outcome without losing an earlier failure. */\nexport function finishWithCleanup<T>(work: () => T, cleanup: () => void): T {\n  let failed = false;\n  let failure: unknown;\n  let value!: T;\n  try { value = work(); }\n  catch (error) { failed = true; failure = error; }\n  try { cleanup(); }\n  catch (error) {\n    if (failed) throw new AggregateError([failure, error], \"Meeko work and cleanup failed\");\n    throw error;\n  }\n  if (failed) throw failure;\n  return value;\n}\n"]}

package/dist/types.d.ts

@@ -1,2 +1,4 @@
+/** Stable ownership marker for generated component declarations. */
+export declare const componentTypeDeclarationMarker = "// @meeko-generated component-declaration v1";
 /** Genera declaraciones TypeScript para un componente y sus imports .meeko relativos. */
 export declare function generateTypes(source: string, filename: string): Promise<string[]>;