@holo-js/cli 0.2.6 → 0.3.1

package/dist/{chunk-KS5TWO75.mjs → chunk-I3RRWDLV.mjs}

@@ -1,21 +1,21 @@
 import {
   fileExists
-} from "./chunk-LBJAJLKU.mjs";
-import {
-  prepareProjectDiscovery
-} from "./chunk-VP2E62DF.mjs";
+} from "./chunk-FFTJKBQF.mjs";
 import {
   loadProjectConfig,
   resolveGeneratedSchemaPath
-} from "./chunk-YEFJBN56.mjs";
+} from "./chunk-4VYR2ARA.mjs";
+import {
+  prepareProjectDiscovery
+} from "./chunk-7KZVFDSI.mjs";
 import {
   loadGeneratedProjectRegistry
-} from "./chunk-J76GH2DR.mjs";
+} from "./chunk-L3YATEQY.mjs";
 import {
   CLI_RUNTIME_ROOT,
   GENERATED_SCHEMA_RUNTIME_PATH,
   bundleProjectModule
-} from "./chunk-ILU426CF.mjs";
+} from "./chunk-PVVGQSUP.mjs";
 
 // src/runtime.ts
 import { spawn } from "child_process";

package/dist/{chunk-J76GH2DR.mjs → chunk-L3YATEQY.mjs}

@@ -29,11 +29,12 @@ import {
   GENERATED_SVELTE_SERVER_HOOKS_PATH,
   GENERATED_TSCONFIG_PATH,
   SUPPORTED_CONFIG_EXTENSIONS,
+  getFrameworkDescriptor,
   importProjectModule,
   isRecord,
   makeProjectRelativePath,
   normalizeScaffoldOptionalPackages
-} from "./chunk-ILU426CF.mjs";
+} from "./chunk-PVVGQSUP.mjs";
 
 // src/templates.ts
 import { dirname, relative, resolve } from "path";
@@ -888,13 +889,9 @@ function renderSveltePage(projectName) {
 }
 function renderSvelteHoloHelper() {
   return [
-    "import { dirname, resolve } from 'node:path'",
-    "import { fileURLToPath } from 'node:url'",
     "import { createSvelteKitHoloHelpers } from '@holo-js/adapter-sveltekit'",
     "",
-    "const projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../..')",
-    "",
-    "export const holo = createSvelteKitHoloHelpers({ projectRoot })",
+    "export const holo = createSvelteKitHoloHelpers()",
     ""
   ].join("\n");
 }
@@ -956,71 +953,117 @@ function renderSvelteHostedAuthRouteFiles(provider) {
     { path: `src/routes/api/auth/${provider}/logout/+server.ts`, contents: renderSvelteHostedAuthLogoutRoute(spec) }
   ];
 }
-function renderAuthProviderRouteFiles(framework, features) {
-  return getRequestedHostedAuthProviders(features).flatMap((provider) => {
-    if (framework === "nuxt") {
-      return renderNuxtHostedAuthRouteFiles(provider);
-    }
-    if (framework === "next") {
-      return renderNextHostedAuthRouteFiles(provider);
+var FRAMEWORK_RENDERERS = {
+  nuxt: {
+    authProviderRouteFiles: renderNuxtHostedAuthRouteFiles,
+    authRouteFiles: () => [
+      { path: "server/api/auth/user.get.ts", contents: renderNuxtCurrentAuthRoute() }
+    ],
+    managedHostedAuthRouteFiles: () => [],
+    broadcastInstallFiles: () => [],
+    broadcastAuthSupportFiles: () => [],
+    frameworkFiles: (options) => {
+      const optionalPackages = normalizeScaffoldOptionalPackages(options.optionalPackages);
+      const authEnabled = optionalPackages.includes("auth");
+      return [
+        { path: "app/app.vue", contents: renderNuxtAppVue(options.projectName) },
+        { path: "nuxt.config.ts", contents: renderNuxtConfig() },
+        { path: "shared/.gitkeep", contents: "" },
+        ...authEnabled ? renderAuthRouteFiles("nuxt") : []
+      ];
     }
-    return renderSvelteHostedAuthRouteFiles(provider);
-  });
-}
-function renderAuthRouteFiles(framework) {
-  if (framework === "next") {
-    return [
+  },
+  next: {
+    authProviderRouteFiles: renderNextHostedAuthRouteFiles,
+    authRouteFiles: () => [
       { path: "app/api/auth/user/route.ts", contents: renderNextCurrentAuthRoute() },
       { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
       { path: ".holo-js/generated/next/bootstrap.mjs", contents: renderNextRuntimeBootstrap() }
-    ];
-  }
-  if (framework === "nuxt") {
-    return [
-      { path: "server/api/auth/user.get.ts", contents: renderNuxtCurrentAuthRoute() }
-    ];
+    ],
+    managedHostedAuthRouteFiles: renderNextManagedHostedAuthRouteFiles,
+    broadcastInstallFiles: () => [
+      { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
+      { path: "app/broadcasting/config/route.ts", contents: renderNextBroadcastConfigRoute() },
+      { path: ".holo-js/generated/next/broadcast-config-route.ts", contents: renderNextGeneratedBroadcastConfigRoute() }
+    ],
+    broadcastAuthSupportFiles: () => [
+      { path: "app/broadcasting/auth/route.ts", contents: renderNextBroadcastAuthRoute() },
+      { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
+      { path: ".holo-js/generated/next/broadcast-auth-route.ts", contents: renderNextGeneratedBroadcastAuthRoute() }
+    ],
+    frameworkFiles: (options) => {
+      const optionalPackages = normalizeScaffoldOptionalPackages(options.optionalPackages);
+      const storageEnabled = optionalPackages.includes("storage");
+      const authEnabled = optionalPackages.includes("auth");
+      const broadcastEnabled = optionalPackages.includes("broadcast");
+      const realtimeEnabled = optionalPackages.includes("realtime");
+      return [
+        { path: "next.config.ts", contents: renderNextConfig() },
+        { path: "next-env.d.ts", contents: renderNextEnvDts() },
+        { path: "app/layout.tsx", contents: renderNextLayout(options.projectName) },
+        { path: "app/page.tsx", contents: renderNextPage(options.projectName) },
+        ...authEnabled ? [{ path: "app/api/auth/user/route.ts", contents: renderNextCurrentAuthRoute() }] : [],
+        ...storageEnabled ? [{ path: "app/storage/[[...path]]/route.ts", contents: renderNextStorageRoute() }] : [],
+        ...broadcastEnabled ? [{ path: "app/broadcasting/config/route.ts", contents: renderNextBroadcastConfigRoute() }] : [],
+        ...renderNextManagedRouteFiles({ authEnabled, broadcastEnabled, storageEnabled, realtimeEnabled })
+      ];
+    }
+  },
+  sveltekit: {
+    authProviderRouteFiles: renderSvelteHostedAuthRouteFiles,
+    authRouteFiles: () => [],
+    managedHostedAuthRouteFiles: () => [],
+    broadcastInstallFiles: () => [
+      { path: ".holo-js/generated/sveltekit/holo.ts", contents: renderSvelteHoloHelper() }
+    ],
+    broadcastAuthSupportFiles: () => [
+      { path: ".holo-js/generated/sveltekit/holo.ts", contents: renderSvelteHoloHelper() }
+    ],
+    frameworkFiles: (options) => {
+      const optionalPackages = normalizeScaffoldOptionalPackages(options.optionalPackages);
+      const storageEnabled = optionalPackages.includes("storage");
+      const authEnabled = optionalPackages.includes("auth");
+      const realtimeEnabled = optionalPackages.includes("realtime");
+      return [
+        { path: "svelte.config.js", contents: renderSvelteConfig() },
+        { path: "vite.config.ts", contents: renderSvelteViteConfig(storageEnabled, realtimeEnabled) },
+        { path: "src/hooks.ts", contents: renderSvelteUserHooks() },
+        { path: "src/hooks.server.ts", contents: renderSvelteServerUserHooks() },
+        { path: "src/app.html", contents: renderSvelteAppHtml() },
+        { path: "src/routes/+page.svelte", contents: renderSveltePage(options.projectName) },
+        ...authEnabled ? renderAuthRouteFiles("sveltekit") : [],
+        ...renderSvelteManagedRuntimeFiles()
+      ];
+    }
   }
-  return [];
+};
+function getFrameworkRenderer(framework) {
+  return FRAMEWORK_RENDERERS[framework];
+}
+function renderAuthProviderRouteFiles(framework, features) {
+  const renderer = getFrameworkRenderer(framework);
+  return getRequestedHostedAuthProviders(features).flatMap((provider) => renderer.authProviderRouteFiles(provider));
+}
+function renderAuthRouteFiles(framework) {
+  return getFrameworkRenderer(framework).authRouteFiles();
+}
+function renderManagedHostedAuthRouteFiles(framework, features) {
+  return getFrameworkRenderer(framework).managedHostedAuthRouteFiles(features);
+}
+function renderBroadcastInstallFrameworkFiles(framework) {
+  return getFrameworkRenderer(framework).broadcastInstallFiles();
+}
+function renderBroadcastAuthSupportFrameworkFiles(framework) {
+  return getFrameworkRenderer(framework).broadcastAuthSupportFiles();
 }
 function renderFrameworkFiles(options) {
-  const optionalPackages = normalizeScaffoldOptionalPackages(options.optionalPackages);
-  const storageEnabled = optionalPackages.includes("storage");
-  const authEnabled = optionalPackages.includes("auth");
-  const broadcastEnabled = optionalPackages.includes("broadcast");
-  const realtimeEnabled = optionalPackages.includes("realtime");
-  if (options.framework === "nuxt") {
-    return [
-      { path: "app/app.vue", contents: renderNuxtAppVue(options.projectName) },
-      { path: "nuxt.config.ts", contents: renderNuxtConfig() },
-      { path: "shared/.gitkeep", contents: "" },
-      ...authEnabled ? renderAuthRouteFiles("nuxt") : []
-    ];
-  }
-  if (options.framework === "next") {
-    return [
-      { path: "next.config.ts", contents: renderNextConfig() },
-      { path: "next-env.d.ts", contents: renderNextEnvDts() },
-      { path: "app/layout.tsx", contents: renderNextLayout(options.projectName) },
-      { path: "app/page.tsx", contents: renderNextPage(options.projectName) },
-      ...authEnabled ? [{ path: "app/api/auth/user/route.ts", contents: renderNextCurrentAuthRoute() }] : [],
-      ...storageEnabled ? [{ path: "app/storage/[[...path]]/route.ts", contents: renderNextStorageRoute() }] : [],
-      ...broadcastEnabled ? [{ path: "app/broadcasting/config/route.ts", contents: renderNextBroadcastConfigRoute() }] : [],
-      ...renderNextManagedRouteFiles({ authEnabled, broadcastEnabled, storageEnabled, realtimeEnabled })
-    ];
-  }
-  return [
-    { path: "svelte.config.js", contents: renderSvelteConfig() },
-    { path: "vite.config.ts", contents: renderSvelteViteConfig(storageEnabled, realtimeEnabled) },
-    { path: "src/hooks.ts", contents: renderSvelteUserHooks() },
-    { path: "src/hooks.server.ts", contents: renderSvelteServerUserHooks() },
-    { path: "src/app.html", contents: renderSvelteAppHtml() },
-    { path: "src/routes/+page.svelte", contents: renderSveltePage(options.projectName) },
-    ...authEnabled ? renderAuthRouteFiles("sveltekit") : [],
-    ...renderSvelteManagedRuntimeFiles()
-  ];
+  return getFrameworkRenderer(options.framework).frameworkFiles(options);
 }
 function renderFrameworkRunner(options) {
-  const commandName = options.framework === "nuxt" ? "nuxt" : options.framework === "next" ? "next" : "vite";
+  return renderFrameworkRunnerForDescriptor(getFrameworkDescriptor(options.framework));
+}
+function renderFrameworkRunnerForDescriptor(descriptor) {
+  const runner = descriptor.runner;
   return [
     "import { existsSync, readFileSync, readlinkSync } from 'node:fs'",
     "import { dirname, resolve } from 'node:path'",
@@ -1034,7 +1077,8 @@ function renderFrameworkRunner(options) {
     "const nextRuntimeBootstrapPath = resolve(projectRoot, '.holo-js/generated/next/bootstrap.mjs')",
     "const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))",
     "const framework = String(manifest.framework ?? '')",
-    `const commandName = ${JSON.stringify(commandName)}`,
+    `const runner = ${JSON.stringify(runner)}`,
+    `const commandName = ${JSON.stringify(runner.commandName)}`,
     "const passthroughArgs = process.argv.slice(3)",
     "const binaryPath = resolve(",
     "  projectRoot,",
@@ -1043,27 +1087,26 @@ function renderFrameworkRunner(options) {
     "  process.platform === 'win32' ? `${commandName}.cmd` : commandName,",
     ")",
     "",
+    "function resolveProjectPath(value) {",
+    "  return resolve(projectRoot, value)",
+    "}",
+    "",
     "function resolveCommandInvocation() {",
     "  if (mode === 'dev') {",
     "    return { command: binaryPath, args: ['dev'] }",
     "  }",
     "",
     "  if (mode === 'build') {",
-    "    return { command: binaryPath, args: framework === 'sveltekit' ? ['build', '--logLevel', 'error'] : ['build'] }",
+    "    return { command: binaryPath, args: [...runner.buildArgs] }",
     "  }",
     "",
     "  if (mode === 'start') {",
-    "    if (framework === 'next') {",
-    "      return { command: binaryPath, args: ['start', ...passthroughArgs] }",
-    "    }",
-    "",
-    "    if (framework === 'nuxt') {",
-    "      return { command: process.execPath, args: [resolve(projectRoot, '.output/server/index.mjs'), ...passthroughArgs] }",
+    "    if (runner.startUsesFrameworkBinary) {",
+    "      return { command: binaryPath, args: [...runner.start, ...passthroughArgs] }",
     "    }",
     "",
-    "    if (framework === 'sveltekit') {",
-    "      return { command: process.execPath, args: [resolve(projectRoot, 'build/index.js'), ...passthroughArgs] }",
-    "    }",
+    "    const [entry, ...args] = runner.start",
+    "    return { command: process.execPath, args: [resolveProjectPath(entry), ...args, ...passthroughArgs] }",
     "  }",
     "",
     "  return undefined",
@@ -1076,7 +1119,7 @@ function renderFrameworkRunner(options) {
     "  process.exit(1)",
     "}",
     "",
-    "const suppressedOutput = framework === 'sveltekit'",
+    "const suppressedOutput = runner.suppressSvelteKitOutput",
     "  ? new Set([",
     `      '"try_get_request_store" is imported from external module "@sveltejs/kit/internal/server" but never used in ".svelte-kit/adapter-node/index.js".',`,
     "    ])",
@@ -1087,7 +1130,7 @@ function renderFrameworkRunner(options) {
     "    return true",
     "  }",
     "",
-    "  return framework === 'sveltekit'",
+    "  return runner.suppressSvelteKitOutput",
     "    && line.startsWith('Circular dependency: ')",
     "    && line.includes('/node_modules/semver/')",
     "}",
@@ -1121,7 +1164,7 @@ function renderFrameworkRunner(options) {
     "}",
     "",
     "function extractNextConflictInfo(lines) {",
-    "  if (framework !== 'next' || mode !== 'dev') {",
+    "  if (!runner.nextDevServerConflictHandling || mode !== 'dev') {",
     "    return undefined",
     "  }",
     "",
@@ -1232,12 +1275,12 @@ function renderFrameworkRunner(options) {
     "  return waitForProcessExit(pid)",
     "}",
     "",
-    "if ((mode !== 'start' || framework === 'next') && !existsSync(binaryPath)) {",
+    "if ((mode !== 'start' || runner.startUsesFrameworkBinary) && !existsSync(binaryPath)) {",
     '  console.error(`[holo] Missing framework binary "${commandName}" for "${framework}". Run your package manager install first.`)',
     "  process.exit(1)",
     "}",
     "",
-    "if (mode === 'start' && framework !== 'next' && !existsSync(commandInvocation.args[0])) {",
+    "if (mode === 'start' && !runner.startUsesFrameworkBinary && !existsSync(commandInvocation.args[0])) {",
     '  console.error(`[holo] Missing production server entry "${commandInvocation.args[0]}". Run "holo build" before "holo start".`)',
     "  process.exit(1)",
     "}",
@@ -1283,7 +1326,7 @@ function renderFrameworkRunner(options) {
     "      childEnv.HOLO_INTERNAL_FRAMEWORK_BUILD = '1'",
     "    }",
     "    const preloads = [runtimeSchemaPath]",
-    "    if (framework === 'next') {",
+    "    if (runner.preloadNextRuntime) {",
     "      preloads.push(nextRuntimeBootstrapPath)",
     "    }",
     "    const preloadOptions = preloads",
@@ -1356,7 +1399,8 @@ import { constants as fsConstants } from "fs";
 import { access, mkdir as mkdir2, readFile as readFile2, readdir as readdir2, writeFile as writeFile2 } from "fs/promises";
 import { dirname as dirname3, extname as extname2, join, resolve as resolve3 } from "path";
 import { loadConfigDirectory } from "@holo-js/config";
-import { DEFAULT_HOLO_PROJECT_PATHS, renderGeneratedSchemaRuntimeModule } from "@holo-js/db";
+import { renderGeneratedSchemaRuntimeModule } from "@holo-js/db";
+import { DEFAULT_HOLO_PROJECT_PATHS } from "@holo-js/kernel";
 
 // src/project/registry-svelte.ts
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "fs/promises";
@@ -1873,7 +1917,7 @@ async function removeLegacyManagedHoloHelper(path, managedContents) {
   const trimmedContents = contents?.trim();
   const trimmedManagedContents = managedContents.trim();
   const isLegacyManagedHelper = trimmedContents === [
-    "import { createNextHoloHelpers } from '@holo-js/adapter-next'",
+    "import { createNextHoloHelpers } from '@holo-js/adapter-next/runtime'",
     "",
     "export const holo = createNextHoloHelpers()"
   ].join("\n") || trimmedContents === [
@@ -2825,18 +2869,17 @@ export {
   resolveArtifactPath,
   renderNextHoloHelper,
   renderNextRuntimeBootstrap,
-  renderNextBroadcastAuthRoute,
   renderNextBroadcastConfigRoute,
-  renderNextGeneratedBroadcastConfigRoute,
-  renderNextGeneratedBroadcastAuthRoute,
   renderNextGeneratedRealtimeDefinitions,
-  renderNextManagedHostedAuthRouteFiles,
   renderSvelteViteConfig,
-  renderSvelteHoloHelper,
   renderAuthProviderRouteFiles,
   renderAuthRouteFiles,
+  renderManagedHostedAuthRouteFiles,
+  renderBroadcastInstallFrameworkFiles,
+  renderBroadcastAuthSupportFrameworkFiles,
   renderFrameworkFiles,
   renderFrameworkRunner,
+  renderFrameworkRunnerForDescriptor,
   renderGeneratedModelTypes,
   writeGeneratedProjectRegistry,
   loadGeneratedProjectRegistry

package/dist/{chunk-4K4CWMMP.mjs → chunk-L6FF22IV.mjs}

@@ -1,23 +1,28 @@
 import {
   hasProjectDependency
-} from "./chunk-FGQ2I2YH.mjs";
-import {
-  prepareProjectDiscovery
-} from "./chunk-VP2E62DF.mjs";
+} from "./chunk-CT23GSEC.mjs";
 import {
   syncManagedDriverDependencies
-} from "./chunk-C624G3R2.mjs";
+} from "./chunk-FFTJKBQF.mjs";
 import {
   ensureGeneratedSchemaPlaceholder,
   ensureProjectConfig
-} from "./chunk-YEFJBN56.mjs";
+} from "./chunk-4VYR2ARA.mjs";
+import {
+  prepareProjectDiscovery
+} from "./chunk-7KZVFDSI.mjs";
+import {
+  renderFrameworkRunnerForDescriptor
+} from "./chunk-L3YATEQY.mjs";
 import {
-  renderFrameworkRunner
-} from "./chunk-J76GH2DR.mjs";
+  loadProjectPluginFrameworkDescriptors
+} from "./chunk-3ICVWL2M.mjs";
 import {
+  getFrameworkDescriptorByIdFrom,
+  getFrameworkDescriptorsWith,
   readTextFile,
   writeTextFile
-} from "./chunk-ILU426CF.mjs";
+} from "./chunk-PVVGQSUP.mjs";
 
 // src/dev.ts
 import { spawnSync, spawn } from "child_process";
@@ -120,54 +125,45 @@ async function runProjectStartServer(io, projectRoot, spawnProcess = spawn, pass
     throw new Error(`Project production server failed with exit code ${result.code ?? "unknown"}.`);
   }
 }
-async function runProjectDependencyInstall(io, projectRoot, spawn2 = spawnSync) {
+async function runProjectDependencyInstall(io, projectRoot, spawnProcess = spawn) {
   const invocation = await resolvePackageManagerInstallInvocation(projectRoot);
-  const result = spawn2(invocation.command, [...invocation.args], {
+  const child = spawnProcess(invocation.command, [...invocation.args], {
     cwd: projectRoot,
-    encoding: "utf8",
-    env: process.env
+    env: process.env,
+    stdio: ["ignore", "pipe", "pipe"]
   });
-  if (result.stdout) {
-    io.stdout.write(result.stdout);
+  let stdout = "";
+  let stderr = "";
+  child.stdout?.on("data", (chunk) => stdout += String(chunk));
+  child.stderr?.on("data", (chunk) => stderr += String(chunk));
+  const result = await new Promise((resolvePromise) => {
+    child.on("error", (error) => resolvePromise({ kind: "error", error }));
+    child.on("close", (code) => resolvePromise({ kind: "close", code }));
+  });
+  if (result.kind === "error") {
+    throw result.error;
   }
-  if (result.stderr) {
-    io.stderr.write(result.stderr);
+  if (stdout) {
+    io.stdout.write(stdout);
   }
-  if (result.status !== 0) {
-    throw new Error(result.stderr?.trim() || result.stdout?.trim() || "Project dependency installation failed.");
+  if (stderr) {
+    io.stderr.write(stderr);
   }
-}
-var FRAMEWORK_SYNC_DEFINITIONS = [
-  {
-    framework: "nuxt",
-    commands: {
-      bun: ["bun", "x", "nuxt", "prepare"],
-      npm: ["npm", "exec", "--", "nuxt", "prepare"],
-      pnpm: ["pnpm", "exec", "nuxt", "prepare"],
-      yarn: ["yarn", "run", "nuxt", "prepare"]
-    },
-    errorLabel: "nuxt prepare"
-  },
-  {
-    framework: "sveltekit",
-    commands: {
-      bun: ["bun", "x", "svelte-kit", "sync"],
-      npm: ["npm", "exec", "--", "svelte-kit", "sync"],
-      pnpm: ["pnpm", "exec", "svelte-kit", "sync"],
-      yarn: ["yarn", "run", "svelte-kit", "sync"]
-    },
-    errorLabel: "svelte-kit sync"
+  if (result.code !== 0) {
+    throw new Error(stderr.trim() || stdout.trim() || "Project dependency installation failed.");
   }
-];
+}
 async function runProjectPrepare(projectRoot, io, options = {}) {
   const project = await ensureProjectConfig(projectRoot);
   await ensureGeneratedSchemaPlaceholder(projectRoot, project.config);
   await prepareProjectDiscovery(projectRoot, project.config);
   await refreshFrameworkRunner(projectRoot);
   const syncFramework = options.syncFramework ?? true;
+  const syncDefinitions = syncFramework ? await resolveProjectFrameworkSyncDefinitions(projectRoot) : [];
   if (syncFramework) {
-    await runFrameworkSync(projectRoot, FRAMEWORK_SYNC_DEFINITIONS[0]);
-    await runFrameworkSync(projectRoot, FRAMEWORK_SYNC_DEFINITIONS[1]);
+    for (const definition of syncDefinitions) {
+      await runFrameworkSync(projectRoot, definition);
+    }
   }
   const updatedDependencies = await syncManagedDriverDependencies(projectRoot);
   if (updatedDependencies && io) {
@@ -175,8 +171,9 @@ async function runProjectPrepare(projectRoot, io, options = {}) {
     await prepareProjectDiscovery(projectRoot, project.config);
     await refreshFrameworkRunner(projectRoot);
     if (syncFramework) {
-      await runFrameworkSync(projectRoot, FRAMEWORK_SYNC_DEFINITIONS[0]);
-      await runFrameworkSync(projectRoot, FRAMEWORK_SYNC_DEFINITIONS[1]);
+      for (const definition of syncDefinitions) {
+        await runFrameworkSync(projectRoot, definition);
+      }
     }
   }
 }
@@ -186,35 +183,53 @@ async function runProjectHotPrepare(projectRoot, io) {
 async function refreshFrameworkRunner(projectRoot) {
   const frameworkProjectPath = resolve(projectRoot, ".holo-js/framework/project.json");
   const frameworkRunnerPath = resolve(projectRoot, ".holo-js/framework/run.mjs");
-  const framework = await resolveProjectFramework(projectRoot, frameworkProjectPath);
-  if (!framework) {
+  const descriptor = await resolveProjectFramework(projectRoot, frameworkProjectPath);
+  if (!descriptor) {
     return;
   }
-  await writeTextFile(frameworkProjectPath, `${JSON.stringify({ framework }, null, 2)}
+  await writeTextFile(frameworkProjectPath, `${JSON.stringify({ framework: descriptor.id }, null, 2)}
 `);
-  await writeTextFile(frameworkRunnerPath, renderFrameworkRunner({ framework }));
+  await writeTextFile(frameworkRunnerPath, renderFrameworkRunnerForDescriptor(descriptor));
 }
 async function resolveProjectFramework(projectRoot, frameworkProjectPath) {
+  const pluginDescriptors = await loadProjectPluginFrameworkDescriptors(projectRoot);
   try {
     const content = await readFile(frameworkProjectPath, "utf8");
     const manifest = JSON.parse(content);
-    if (manifest.framework !== "next" && manifest.framework !== "nuxt" && manifest.framework !== "sveltekit") {
-      return;
-    }
-    return manifest.framework;
+    const descriptor = typeof manifest.framework === "string" ? getFrameworkDescriptorByIdFrom(manifest.framework, pluginDescriptors) : void 0;
+    return descriptor ?? resolveProjectFrameworkFromDependencies(projectRoot, pluginDescriptors);
   } catch {
+    return resolveProjectFrameworkFromDependencies(projectRoot, pluginDescriptors);
   }
-  if (await hasProjectDependency(projectRoot, "next")) {
-    return "next";
-  }
-  if (await hasProjectDependency(projectRoot, "nuxt")) {
-    return "nuxt";
-  }
-  if (await hasProjectDependency(projectRoot, "@sveltejs/kit")) {
-    return "sveltekit";
+}
+async function resolveProjectFrameworkFromDependencies(projectRoot, pluginDescriptors = []) {
+  for (const descriptor of getFrameworkDescriptorsWith(pluginDescriptors)) {
+    const matches = await Promise.all(
+      descriptor.detectPackages.map((packageName) => hasProjectDependency(projectRoot, packageName))
+    );
+    if (matches.some(Boolean)) {
+      return descriptor;
+    }
   }
   return void 0;
 }
+async function resolveProjectFrameworkSyncDefinitions(projectRoot) {
+  const pluginDescriptors = await loadProjectPluginFrameworkDescriptors(projectRoot);
+  const seen = /* @__PURE__ */ new Set();
+  const definitions = [];
+  for (const descriptor of getFrameworkDescriptorsWith(pluginDescriptors)) {
+    if (!descriptor.sync || seen.has(descriptor.id)) {
+      continue;
+    }
+    seen.add(descriptor.id);
+    definitions.push({
+      framework: descriptor.id,
+      commands: descriptor.sync.commands,
+      errorLabel: descriptor.sync.errorLabel
+    });
+  }
+  return Object.freeze(definitions);
+}
 async function runFrameworkSync(projectRoot, definition) {
   const frameworkProjectPath = resolve(projectRoot, ".holo-js/framework/project.json");
   try {