veryfront 0.1.129 → 0.1.130

package/esm/cli/commands/config/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const configHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/config/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/config/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAYxB,CAAC"}

package/esm/cli/commands/config/command-help.js

@@ -0,0 +1,13 @@
+export const configHelp = {
+    name: "config",
+    category: "project",
+    description: "Show effective project configuration",
+    usage: "veryfront config [options]",
+    options: [
+        { flag: "--json", description: "Output as JSON" },
+    ],
+    examples: [
+        "veryfront config",
+        "veryfront config --json",
+    ],
+};

package/esm/cli/commands/config/handler.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedArgs } from "../../shared/types.js";
+export declare function detectConfigSource(projectDir: string): Promise<string | null>;
+export declare function getEnvOverrides(): string[];
+export declare function handleConfigCommand(_args: ParsedArgs): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/config/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/config/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAexD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAM1C;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C1E"}

package/esm/cli/commands/config/handler.js

@@ -0,0 +1,70 @@
+import { cliLogger } from "../../utils/index.js";
+import { getEnv } from "../../../src/platform/index.js";
+import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
+import { bold, dim } from "../../ui/colors.js";
+const ENV_OVERRIDES = {
+    projectSlug: "VERYFRONT_PROJECT_SLUG",
+    apiBaseUrl: "VERYFRONT_API_BASE_URL",
+    apiToken: "VERYFRONT_API_TOKEN",
+    nodeEnv: "NODE_ENV",
+    veryfrontEnv: "VERYFRONT_ENV",
+    debug: "VERYFRONT_DEBUG",
+};
+export async function detectConfigSource(projectDir) {
+    const { createFileSystem } = await import("../../../src/platform/index.js");
+    const { join } = await import("../../../src/platform/compat/path/index.js");
+    const fs = createFileSystem();
+    for (const name of [
+        "veryfront.config.ts",
+        "veryfront.config.js",
+        "veryfront.json",
+    ]) {
+        if (await fs.exists(join(projectDir, name)))
+            return name;
+    }
+    return null;
+}
+export function getEnvOverrides() {
+    const overrides = [];
+    for (const [field, envVar] of Object.entries(ENV_OVERRIDES)) {
+        if (getEnv(envVar))
+            overrides.push(`${field} (${envVar})`);
+    }
+    return overrides;
+}
+export async function handleConfigCommand(_args) {
+    const { getEnvironmentConfig } = await import("../../../src/config/index.js");
+    const { cwd } = await import("../../../src/platform/index.js");
+    const config = getEnvironmentConfig();
+    const projectDir = cwd();
+    const configSource = await detectConfigSource(projectDir);
+    const envOverrides = getEnvOverrides();
+    const configData = {
+        projectSlug: config.projectSlug ?? null,
+        nodeEnv: config.nodeEnv,
+        veryfrontEnv: config.veryfrontEnv || null,
+        apiBaseUrl: config.apiBaseUrl,
+        debug: config.debug,
+        ci: config.ci,
+        hasApiToken: !!config.apiToken,
+        configSource,
+        envOverrides,
+    };
+    if (isJsonMode()) {
+        await outputJson(createSuccessEnvelope("config", configData));
+        return;
+    }
+    cliLogger.info(`\n  ${bold("Project Configuration")}\n`);
+    cliLogger.info(`  ${dim("Project slug:")}  ${configData.projectSlug ?? "(not set)"}`);
+    cliLogger.info(`  ${dim("Environment:")}   ${configData.nodeEnv}`);
+    cliLogger.info(`  ${dim("VF Environment:")} ${configData.veryfrontEnv ?? "(not set)"}`);
+    cliLogger.info(`  ${dim("API endpoint:")}  ${configData.apiBaseUrl}`);
+    cliLogger.info(`  ${dim("Debug:")}         ${configData.debug}`);
+    cliLogger.info(`  ${dim("CI:")}            ${configData.ci}`);
+    cliLogger.info(`  ${dim("Authenticated:")} ${configData.hasApiToken ? "yes" : "no"}`);
+    cliLogger.info(`  ${dim("Config file:")}   ${configData.configSource ?? "(none)"}`);
+    if (envOverrides.length > 0) {
+        cliLogger.info(`  ${dim("Env overrides:")}  ${envOverrides.join(", ")}`);
+    }
+    cliLogger.info("");
+}

package/esm/cli/commands/open/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const openHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/open/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAgBtB,CAAC"}

package/esm/cli/commands/open/command-help.js

@@ -0,0 +1,17 @@
+export const openHelp = {
+    name: "open",
+    category: "project",
+    description: "Open project URLs in the browser",
+    usage: "veryfront open [options]",
+    options: [
+        { flag: "--env <name>", description: "Open a specific environment URL" },
+        { flag: "--studio", description: "Open Veryfront Studio" },
+        { flag: "--json", description: "Output URL as JSON instead of opening" },
+    ],
+    examples: [
+        "veryfront open",
+        "veryfront open --env staging",
+        "veryfront open --studio",
+        "veryfront open --json",
+    ],
+};

package/esm/cli/commands/open/command.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const OpenArgsSchema: z.ZodObject<{
+    env: z.ZodOptional<z.ZodString>;
+    studio: z.ZodDefault<z.ZodBoolean>;
+    projectSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type OpenOptions = z.infer<typeof OpenArgsSchema>;
+export declare const parseOpenArgs: (args: import("../../shared/types.js").ParsedArgs) => import("../../shared/args.js").SafeParseResult<{
+    studio: boolean;
+    env?: string | undefined;
+    projectSlug?: string | undefined;
+}>;
+export declare function buildUrl(projectSlug: string, options: OpenOptions): string;
+//# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/open/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEzD,eAAO,MAAM,aAAa;;;;EAIxB,CAAC;AAIH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAQ1E"}

package/esm/cli/commands/open/command.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { createArgParser } from "../../shared/args.js";
+export const OpenArgsSchema = z.object({
+    env: z.string().optional(),
+    studio: z.boolean().default(false),
+    projectSlug: z.string().optional(),
+});
+export const parseOpenArgs = createArgParser(OpenArgsSchema, {
+    env: { keys: ["env"], type: "string" },
+    studio: { keys: ["studio"], type: "boolean" },
+    projectSlug: { keys: ["project-slug", "project", "p"], type: "string" },
+});
+const DASHBOARD_BASE = "https://veryfront.com";
+export function buildUrl(projectSlug, options) {
+    if (options.studio) {
+        return `${DASHBOARD_BASE}/studio/${projectSlug}`;
+    }
+    if (options.env) {
+        return `${DASHBOARD_BASE}/projects/${projectSlug}/environments/${options.env}`;
+    }
+    return `${DASHBOARD_BASE}/projects/${projectSlug}`;
+}

package/esm/cli/commands/open/handler.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from "../../shared/types.js";
+export declare function handleOpenCommand(args: ParsedArgs): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/open/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/open/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMxD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvE"}

package/esm/cli/commands/open/handler.js

@@ -0,0 +1,29 @@
+import { parseArgsOrThrow } from "../../shared/args.js";
+import { cliLogger, exitProcess } from "../../utils/index.js";
+import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
+import { buildUrl, parseOpenArgs } from "./command.js";
+export async function handleOpenCommand(args) {
+    const opts = parseArgsOrThrow(parseOpenArgs, "open", args);
+    let projectSlug = opts.projectSlug;
+    if (!projectSlug) {
+        const { cwd } = await import("../../../src/platform/index.js");
+        const { getEnvironmentConfig } = await import("../../../src/config/index.js");
+        const { readConfigFile } = await import("../../shared/config.js");
+        projectSlug = getEnvironmentConfig().projectSlug ??
+            (await readConfigFile(cwd()))?.projectSlug ??
+            undefined;
+    }
+    if (!projectSlug) {
+        cliLogger.error("No project found. Run from a project directory or use --project-slug");
+        exitProcess(1);
+        return;
+    }
+    const url = buildUrl(projectSlug, opts);
+    if (isJsonMode()) {
+        await outputJson(createSuccessEnvelope("open", { url }));
+        return;
+    }
+    const { openBrowser } = await import("../../auth/browser.js");
+    await openBrowser(url);
+    console.log(`  Opening ${url}`);
+}

package/esm/cli/help/command-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAqCtB,CAAC"}
+{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAyClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAuCtB,CAAC"}

package/esm/cli/help/command-definitions.js

@@ -39,6 +39,8 @@ import { schemaHelp } from "../commands/schema/command-help.js";
 import { testHelp } from "../commands/test/command-help.js";
 import { lintHelp } from "../commands/lint/command-help.js";
 import { skillsHelp } from "../commands/skills/command-help.js";
+import { configHelp } from "../commands/config/command-help.js";
+import { openHelp } from "../commands/open/command-help.js";
 import { completionsHelp } from "../commands/completions/command-help.js";
 /**
  * Central registry of all command help definitions.
@@ -80,5 +82,7 @@ export const COMMANDS = {
     test: testHelp,
     lint: lintHelp,
     skills: skillsHelp,
+    config: configHelp,
+    open: openHelp,
     completions: completionsHelp,
 };

package/esm/cli/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAwDA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiEpD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FlE"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AA0DA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAmEpD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FlE"}

package/esm/cli/router.js

@@ -38,6 +38,8 @@ import { handleSchemaCommand } from "./commands/schema/handler.js";
 import { handleTestCommand } from "./commands/test/handler.js";
 import { handleLintCommand } from "./commands/lint/handler.js";
 import { handleSkillsCommand } from "./commands/skills/handler.js";
+import { handleConfigCommand } from "./commands/config/handler.js";
+import { handleOpenCommand } from "./commands/open/handler.js";
 import { handleCompletionsCommand } from "./commands/completions/handler.js";
 import { login, logout, whoami } from "./auth/index.js";
 import { parseLoginMethod } from "./auth/utils.js";
@@ -95,6 +97,8 @@ const commands = {
     "test": handleTestCommand,
     "lint": handleLintCommand,
     "skills": handleSkillsCommand,
+    "config": handleConfigCommand,
+    "open": handleOpenCommand,
     "completions": handleCompletionsCommand,
 };
 /**

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.129",
+    "version": "0.1.130",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/platform/compat/framework-source-resolver.d.ts

@@ -1,5 +1,6 @@
 import type { FileInfo } from "../adapters/base.js";
 export declare const FRAMEWORK_ROOT: string;
+export declare const FRAMEWORK_SRC_DIR: string;
 export declare const FRAMEWORK_EMBEDDED_SRC_DIR: string;
 export declare const DEFAULT_FRAMEWORK_SOURCE_EXTENSIONS: readonly [".tsx.src", ".ts.src", ".jsx.src", ".js.src", ".mdx.src", ".md.src", ".tsx", ".ts", ".jsx", ".js", ".mdx", ".md"];
 export interface FrameworkSourceFileSystem {
@@ -15,6 +16,13 @@ export interface ResolveFrameworkSourcePathOptions {
     extensions?: readonly string[];
     includeIndexFallback?: boolean;
 }
+export interface ResolveRelativeFrameworkSourceImportOptions {
+    fileSystem?: FrameworkSourceFileSystem;
+    exists?: (path: string) => Promise<boolean>;
+    extensions?: readonly string[];
+}
 export declare function getFrameworkSourceLookupDirs(extraLookupDirs?: string[]): string[];
+export declare function isFrameworkSourcePath(path: string): boolean;
 export declare function resolveFrameworkSourcePath(relativePathWithoutExt: string, options?: ResolveFrameworkSourcePathOptions): Promise<FrameworkSourceLookupResult | null>;
+export declare function resolveRelativeFrameworkSourceImport(specifier: string, fromSourcePath: string, options?: ResolveRelativeFrameworkSourceImportOptions): Promise<string | null>;
 //# sourceMappingURL=framework-source-resolver.d.ts.map

package/esm/src/platform/compat/framework-source-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-source-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/framework-source-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,eAAO,MAAM,cAAc,QAA4C,CAAC;AACxE,eAAO,MAAM,0BAA0B,QAAgD,CAAC;AAExF,eAAO,MAAM,mCAAmC,6HAatC,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,4BAA4B,CAAC,eAAe,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAarF;AAED,wBAAsB,0BAA0B,CAC9C,sBAAsB,EAAE,MAAM,EAC9B,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CA+B7C"}
+{"version":3,"file":"framework-source-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/framework-source-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,eAAO,MAAM,cAAc,QAA4C,CAAC;AACxE,eAAO,MAAM,iBAAiB,QAA8B,CAAC;AAC7D,eAAO,MAAM,0BAA0B,QAAgD,CAAC;AAExF,eAAO,MAAM,mCAAmC,6HAatC,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,2CAA2C;IAC1D,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,wBAAgB,4BAA4B,CAAC,eAAe,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAarF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAuCD,wBAAsB,0BAA0B,CAC9C,sBAAsB,EAAE,MAAM,EAC9B,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CA+B7C;AAED,wBAAsB,oCAAoC,CACxD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,2CAAgD,GACxD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB"}

package/esm/src/platform/compat/framework-source-resolver.js

@@ -1,7 +1,8 @@
 import { join } from "./path/index.js";
 import { createFileSystem } from "./fs.js";
-import { getFrameworkRootFromMeta } from "./vfs-paths.js";
+import { getFrameworkRoot, getFrameworkRootFromMeta } from "./vfs-paths.js";
 export const FRAMEWORK_ROOT = getFrameworkRootFromMeta(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+export const FRAMEWORK_SRC_DIR = join(FRAMEWORK_ROOT, "src");
 export const FRAMEWORK_EMBEDDED_SRC_DIR = join(FRAMEWORK_ROOT, "dist", "framework-src");
 export const DEFAULT_FRAMEWORK_SOURCE_EXTENSIONS = [
     ".tsx.src",
@@ -31,6 +32,40 @@ export function getFrameworkSourceLookupDirs(extraLookupDirs = []) {
         return true;
     });
 }
+export function isFrameworkSourcePath(path) {
+    return path.startsWith(`${FRAMEWORK_SRC_DIR}/`) ||
+        path.startsWith(`${FRAMEWORK_EMBEDDED_SRC_DIR}/`);
+}
+function expandFrameworkCandidatePaths(candidatePath) {
+    const candidates = [candidatePath];
+    const candidateRoot = getFrameworkRoot(candidatePath);
+    const candidateSrcDir = candidateRoot ? join(candidateRoot, "src") : FRAMEWORK_SRC_DIR;
+    const candidateEmbeddedDir = candidateRoot
+        ? join(candidateRoot, "dist", "framework-src")
+        : FRAMEWORK_EMBEDDED_SRC_DIR;
+    if (candidatePath.startsWith(`${candidateSrcDir}/`)) {
+        const relativePath = candidatePath.slice(candidateSrcDir.length + 1);
+        candidates.push(join(candidateEmbeddedDir, relativePath));
+    }
+    return [...new Set(candidates)];
+}
+async function findExistingFrameworkCandidate(candidatePath, options = {}) {
+    const fs = options.fileSystem ?? createFileSystem();
+    const exists = options.exists ?? (async (path) => {
+        try {
+            const stat = await fs.stat(path);
+            return stat.isFile;
+        }
+        catch {
+            return false;
+        }
+    });
+    for (const candidate of expandFrameworkCandidatePaths(candidatePath)) {
+        if (await exists(candidate))
+            return candidate;
+    }
+    return null;
+}
 export async function resolveFrameworkSourcePath(relativePathWithoutExt, options = {}) {
     const fs = options.fileSystem ?? createFileSystem();
     const lookupDirs = getFrameworkSourceLookupDirs(options.extraLookupDirs);
@@ -60,3 +95,44 @@ export async function resolveFrameworkSourcePath(relativePathWithoutExt, options
     }
     return null;
 }
+export async function resolveRelativeFrameworkSourceImport(specifier, fromSourcePath, options = {}) {
+    const extensions = options.extensions ?? DEFAULT_FRAMEWORK_SOURCE_EXTENSIONS;
+    const fromDir = fromSourcePath.substring(0, fromSourcePath.lastIndexOf("/"));
+    const parts = fromDir.split("/").filter(Boolean);
+    const importParts = specifier.split("/").filter(Boolean);
+    for (const part of importParts) {
+        if (part === "..") {
+            parts.pop();
+        }
+        else if (part !== ".") {
+            parts.push(part);
+        }
+    }
+    const basePath = "/" + parts.join("/");
+    if (/\.(tsx?|jsx?|mjs)$/.test(specifier)) {
+        const explicitCandidates = [basePath, `${basePath}.src`];
+        if (basePath.endsWith(".js") || basePath.endsWith(".mjs")) {
+            const stem = basePath.replace(/\.(?:m?js)$/, "");
+            for (const ext of [".ts", ".tsx", ".jsx", ".js", ".mjs"]) {
+                explicitCandidates.push(`${stem}${ext}.src`, `${stem}${ext}`);
+            }
+        }
+        for (const candidate of explicitCandidates) {
+            const resolved = await findExistingFrameworkCandidate(candidate, options);
+            if (resolved)
+                return resolved;
+        }
+        return null;
+    }
+    for (const ext of extensions) {
+        const candidate = await findExistingFrameworkCandidate(basePath + ext, options);
+        if (candidate)
+            return candidate;
+    }
+    for (const ext of extensions) {
+        const candidate = await findExistingFrameworkCandidate(join(basePath, "index" + ext), options);
+        if (candidate)
+            return candidate;
+    }
+    return null;
+}

package/esm/src/transforms/esm/import-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/import-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAKD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAiFlC"}
+{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/import-parser.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAKD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAiFlC"}

package/esm/src/transforms/esm/import-parser.js

@@ -1,6 +1,7 @@
 import { getEsbuild } from "../../platform/compat/esbuild.js";
 import { join } from "../../platform/compat/path/index.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
+import { isFrameworkSourcePath, resolveRelativeFrameworkSourceImport, } from "../../platform/compat/framework-source-resolver.js";
 import { isCrossProjectImport, parseCrossProjectImport } from "./path-resolver.js";
 import { parseImports } from "./lexer.js";
 import { getLoaderFromPath } from "./transform-utils.js";
@@ -94,6 +95,11 @@ async function checkFileExists(path, adapter) {
     }
 }
 async function resolveLocalImportPath(fromFile, importSpecifier, adapter) {
+    if (isFrameworkSourcePath(fromFile)) {
+        const resolvedFrameworkImport = await resolveRelativeFrameworkSourceImport(importSpecifier, fromFile);
+        if (resolvedFrameworkImport)
+            return resolvedFrameworkImport;
+    }
     const fromDir = fromFile.substring(0, fromFile.lastIndexOf("/"));
     const basePath = resolveRelative(fromDir, importSpecifier);
     if (adapter?.fs.resolveFile) {

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.d.ts

@@ -32,5 +32,5 @@ export declare function resolveVeryfrontSourcePath(specifier: string, existsFn?:
  * Handles both regular source files (.tsx, .ts) and embedded sources (.tsx.src, .ts.src)
  * for compiled binaries.
  */
-export declare function resolveRelativeFrameworkImport(specifier: string, fromSourcePath: string, _fs: ReturnType<typeof createFileSystem>, existsFn?: (path: string) => Promise<boolean>): Promise<string | null>;
+export declare function resolveRelativeFrameworkImport(specifier: string, fromSourcePath: string, fs: ReturnType<typeof createFileSystem>, existsFn?: (path: string) => Promise<boolean>): Promise<string | null>;
 //# sourceMappingURL=path-resolver.d.ts.map

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAU,MAAM,mCAAmC,CAAC;AAY7E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmBzD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA6DzD;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkExB;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACxC,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqExB"}
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAU,MAAM,mCAAmC,CAAC;AAa7E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmBzD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA6DzD;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkExB;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAU,GACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.js

@@ -7,6 +7,7 @@
 import { exists } from "../../../../platform/compat/fs.js";
 import { join } from "../../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../../utils/index.js";
+import { resolveRelativeFrameworkSourceImport } from "../../../../platform/compat/framework-source-resolver.js";
 import { resolveInternalModuleTarget } from "../../../veryfront-module-urls.js";
 import { EMBEDDED_SRC_DIR, EXTENSIONS, FRAMEWORK_LOOKUPS, FRAMEWORK_ROOT, LOG_PREFIX, } from "./constants.js";
 export async function tryReadWithExtensions(fs, basePath, existsFn = exists) {
@@ -168,70 +169,13 @@ export async function resolveVeryfrontSourcePath(specifier, existsFn = exists) {
  * Handles both regular source files (.tsx, .ts) and embedded sources (.tsx.src, .ts.src)
  * for compiled binaries.
  */
-export async function resolveRelativeFrameworkImport(specifier, fromSourcePath, _fs, existsFn = exists) {
-    const fromDir = fromSourcePath.substring(0, fromSourcePath.lastIndexOf("/"));
-    const parts = fromDir.split("/").filter(Boolean);
-    const importParts = specifier.split("/").filter(Boolean);
-    for (const part of importParts) {
-        if (part === "..") {
-            parts.pop();
-        }
-        else if (part !== ".") {
-            parts.push(part);
-        }
-    }
-    const basePath = "/" + parts.join("/");
-    // If specifier already has extension (e.g., ./Head.tsx), we need to try:
-    // 1. The exact path (basePath)
-    // 2. The path with .src suffix (basePath.src) for embedded sources
-    // 3. For transpiled .js/.mjs imports, fall back to sibling TS/TSX/JSX sources
-    if (/\.(tsx?|jsx?|mjs)$/.test(specifier)) {
-        const explicitCandidates = [basePath, `${basePath}.src`];
-        // esbuild rewrites TS/TSX relative imports to .js in transformed output.
-        // When the original source only exists as .ts/.tsx (or embedded .src),
-        // probe those sibling source extensions before giving up.
-        if (basePath.endsWith(".js") || basePath.endsWith(".mjs")) {
-            const stem = basePath.replace(/\.(?:m?js)$/, "");
-            for (const ext of [".ts", ".tsx", ".jsx", ".js", ".mjs"]) {
-                explicitCandidates.push(`${stem}${ext}.src`, `${stem}${ext}`);
-            }
-        }
-        for (const candidate of explicitCandidates) {
-            try {
-                if (await existsFn(candidate))
-                    return candidate;
-            }
-            catch (_) {
-                /* expected: file may not exist at this path */
-            }
-        }
-        return null;
-    }
-    // No extension provided - try all extensions (including .src for embedded sources)
-    const allExtensions = [
-        ...EXTENSIONS.map((ext) => ext + ".src"),
-        ...EXTENSIONS,
-    ];
-    for (const ext of allExtensions) {
-        const pathWithExt = basePath + ext;
-        try {
-            if (await existsFn(pathWithExt))
-                return pathWithExt;
-        }
-        catch (_) {
-            /* expected: file may not exist at this path */
-        }
-    }
-    // Try index file
-    for (const ext of allExtensions) {
-        const indexPath = join(basePath, "index" + ext);
-        try {
-            if (await existsFn(indexPath))
-                return indexPath;
-        }
-        catch (_) {
-            /* expected: file may not exist at this path */
-        }
-    }
-    return null;
+export async function resolveRelativeFrameworkImport(specifier, fromSourcePath, fs, existsFn = exists) {
+    return await resolveRelativeFrameworkSourceImport(specifier, fromSourcePath, {
+        fileSystem: fs,
+        exists: existsFn,
+        extensions: [
+            ...EXTENSIONS.map((ext) => `${ext}.src`),
+            ...EXTENSIONS,
+        ],
+    });
 }

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.129";
+export declare const VERSION = "0.1.130";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.129";
+export const VERSION = "0.1.130";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.129",
+  "version": "0.1.130",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/cli/commands/config/command-help.ts

@@ -0,0 +1,15 @@
+import type { CommandHelp } from "../../help/types.js";
+
+export const configHelp: CommandHelp = {
+  name: "config",
+  category: "project",
+  description: "Show effective project configuration",
+  usage: "veryfront config [options]",
+  options: [
+    { flag: "--json", description: "Output as JSON" },
+  ],
+  examples: [
+    "veryfront config",
+    "veryfront config --json",
+  ],
+};

package/src/cli/commands/config/handler.ts

@@ -0,0 +1,90 @@
+import type { ParsedArgs } from "../../shared/types.js";
+import { cliLogger } from "../../utils/index.js";
+import { getEnv } from "../../../src/platform/index.js";
+import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
+import { bold, dim } from "../../ui/colors.js";
+
+const ENV_OVERRIDES: Record<string, string> = {
+  projectSlug: "VERYFRONT_PROJECT_SLUG",
+  apiBaseUrl: "VERYFRONT_API_BASE_URL",
+  apiToken: "VERYFRONT_API_TOKEN",
+  nodeEnv: "NODE_ENV",
+  veryfrontEnv: "VERYFRONT_ENV",
+  debug: "VERYFRONT_DEBUG",
+};
+
+export async function detectConfigSource(
+  projectDir: string,
+): Promise<string | null> {
+  const { createFileSystem } = await import("../../../src/platform/index.js");
+  const { join } = await import("../../../src/platform/compat/path/index.js");
+  const fs = createFileSystem();
+
+  for (
+    const name of [
+      "veryfront.config.ts",
+      "veryfront.config.js",
+      "veryfront.json",
+    ]
+  ) {
+    if (await fs.exists(join(projectDir, name))) return name;
+  }
+  return null;
+}
+
+export function getEnvOverrides(): string[] {
+  const overrides: string[] = [];
+  for (const [field, envVar] of Object.entries(ENV_OVERRIDES)) {
+    if (getEnv(envVar)) overrides.push(`${field} (${envVar})`);
+  }
+  return overrides;
+}
+
+export async function handleConfigCommand(_args: ParsedArgs): Promise<void> {
+  const { getEnvironmentConfig } = await import("../../../src/config/index.js");
+  const { cwd } = await import("../../../src/platform/index.js");
+  const config = getEnvironmentConfig();
+
+  const projectDir = cwd();
+  const configSource = await detectConfigSource(projectDir);
+  const envOverrides = getEnvOverrides();
+
+  const configData = {
+    projectSlug: config.projectSlug ?? null,
+    nodeEnv: config.nodeEnv,
+    veryfrontEnv: config.veryfrontEnv || null,
+    apiBaseUrl: config.apiBaseUrl,
+    debug: config.debug,
+    ci: config.ci,
+    hasApiToken: !!config.apiToken,
+    configSource,
+    envOverrides,
+  };
+
+  if (isJsonMode()) {
+    await outputJson(createSuccessEnvelope("config", configData));
+    return;
+  }
+
+  cliLogger.info(`\n  ${bold("Project Configuration")}\n`);
+  cliLogger.info(
+    `  ${dim("Project slug:")}  ${configData.projectSlug ?? "(not set)"}`,
+  );
+  cliLogger.info(`  ${dim("Environment:")}   ${configData.nodeEnv}`);
+  cliLogger.info(
+    `  ${dim("VF Environment:")} ${configData.veryfrontEnv ?? "(not set)"}`,
+  );
+  cliLogger.info(`  ${dim("API endpoint:")}  ${configData.apiBaseUrl}`);
+  cliLogger.info(`  ${dim("Debug:")}         ${configData.debug}`);
+  cliLogger.info(`  ${dim("CI:")}            ${configData.ci}`);
+  cliLogger.info(
+    `  ${dim("Authenticated:")} ${configData.hasApiToken ? "yes" : "no"}`,
+  );
+  cliLogger.info(
+    `  ${dim("Config file:")}   ${configData.configSource ?? "(none)"}`,
+  );
+  if (envOverrides.length > 0) {
+    cliLogger.info(`  ${dim("Env overrides:")}  ${envOverrides.join(", ")}`);
+  }
+  cliLogger.info("");
+}

package/src/cli/commands/open/command-help.ts

@@ -0,0 +1,19 @@
+import type { CommandHelp } from "../../help/types.js";
+
+export const openHelp: CommandHelp = {
+  name: "open",
+  category: "project",
+  description: "Open project URLs in the browser",
+  usage: "veryfront open [options]",
+  options: [
+    { flag: "--env <name>", description: "Open a specific environment URL" },
+    { flag: "--studio", description: "Open Veryfront Studio" },
+    { flag: "--json", description: "Output URL as JSON instead of opening" },
+  ],
+  examples: [
+    "veryfront open",
+    "veryfront open --env staging",
+    "veryfront open --studio",
+    "veryfront open --json",
+  ],
+};

package/src/cli/commands/open/command.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { createArgParser } from "../../shared/args.js";
+
+export const OpenArgsSchema = z.object({
+  env: z.string().optional(),
+  studio: z.boolean().default(false),
+  projectSlug: z.string().optional(),
+});
+
+export type OpenOptions = z.infer<typeof OpenArgsSchema>;
+
+export const parseOpenArgs = createArgParser(OpenArgsSchema, {
+  env: { keys: ["env"], type: "string" },
+  studio: { keys: ["studio"], type: "boolean" },
+  projectSlug: { keys: ["project-slug", "project", "p"], type: "string" },
+});
+
+const DASHBOARD_BASE = "https://veryfront.com";
+
+export function buildUrl(projectSlug: string, options: OpenOptions): string {
+  if (options.studio) {
+    return `${DASHBOARD_BASE}/studio/${projectSlug}`;
+  }
+  if (options.env) {
+    return `${DASHBOARD_BASE}/projects/${projectSlug}/environments/${options.env}`;
+  }
+  return `${DASHBOARD_BASE}/projects/${projectSlug}`;
+}

package/src/cli/commands/open/handler.ts

@@ -0,0 +1,38 @@
+import type { ParsedArgs } from "../../shared/types.js";
+import { parseArgsOrThrow } from "../../shared/args.js";
+import { cliLogger, exitProcess } from "../../utils/index.js";
+import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
+import { buildUrl, parseOpenArgs } from "./command.js";
+
+export async function handleOpenCommand(args: ParsedArgs): Promise<void> {
+  const opts = parseArgsOrThrow(parseOpenArgs, "open", args);
+
+  let projectSlug = opts.projectSlug;
+  if (!projectSlug) {
+    const { cwd } = await import("../../../src/platform/index.js");
+    const { getEnvironmentConfig } = await import("../../../src/config/index.js");
+    const { readConfigFile } = await import("../../shared/config.js");
+    projectSlug = getEnvironmentConfig().projectSlug ??
+      (await readConfigFile(cwd()))?.projectSlug ??
+      undefined;
+  }
+
+  if (!projectSlug) {
+    cliLogger.error(
+      "No project found. Run from a project directory or use --project-slug",
+    );
+    exitProcess(1);
+    return;
+  }
+
+  const url = buildUrl(projectSlug, opts);
+
+  if (isJsonMode()) {
+    await outputJson(createSuccessEnvelope("open", { url }));
+    return;
+  }
+
+  const { openBrowser } = await import("../../auth/browser.js");
+  await openBrowser(url);
+  console.log(`  Opening ${url}`);
+}

package/src/cli/help/command-definitions.ts

@@ -42,6 +42,8 @@ import { schemaHelp } from "../commands/schema/command-help.js";
 import { testHelp } from "../commands/test/command-help.js";
 import { lintHelp } from "../commands/lint/command-help.js";
 import { skillsHelp } from "../commands/skills/command-help.js";
+import { configHelp } from "../commands/config/command-help.js";
+import { openHelp } from "../commands/open/command-help.js";
 import { completionsHelp } from "../commands/completions/command-help.js";
 
 /**
@@ -84,5 +86,7 @@ export const COMMANDS: CommandRegistry = {
   test: testHelp,
   lint: lintHelp,
   skills: skillsHelp,
+  config: configHelp,
+  open: openHelp,
   completions: completionsHelp,
 };

package/src/cli/router.ts

@@ -40,6 +40,8 @@ import { handleSchemaCommand } from "./commands/schema/handler.js";
 import { handleTestCommand } from "./commands/test/handler.js";
 import { handleLintCommand } from "./commands/lint/handler.js";
 import { handleSkillsCommand } from "./commands/skills/handler.js";
+import { handleConfigCommand } from "./commands/config/handler.js";
+import { handleOpenCommand } from "./commands/open/handler.js";
 import { handleCompletionsCommand } from "./commands/completions/handler.js";
 import { login, logout, whoami } from "./auth/index.js";
 import { parseLoginMethod } from "./auth/utils.js";
@@ -105,6 +107,8 @@ const commands: Record<string, (args: ParsedArgs) => Promise<void>> = {
   "test": handleTestCommand,
   "lint": handleLintCommand,
   "skills": handleSkillsCommand,
+  "config": handleConfigCommand,
+  "open": handleOpenCommand,
   "completions": handleCompletionsCommand,
 };
 

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.129",
+  "version": "0.1.130",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/platform/compat/framework-source-resolver.ts

@@ -1,9 +1,10 @@
 import { join } from "./path/index.js";
 import type { FileInfo } from "../adapters/base.js";
 import { createFileSystem } from "./fs.js";
-import { getFrameworkRootFromMeta } from "./vfs-paths.js";
+import { getFrameworkRoot, getFrameworkRootFromMeta } from "./vfs-paths.js";
 
 export const FRAMEWORK_ROOT = getFrameworkRootFromMeta(import.meta.url);
+export const FRAMEWORK_SRC_DIR = join(FRAMEWORK_ROOT, "src");
 export const FRAMEWORK_EMBEDDED_SRC_DIR = join(FRAMEWORK_ROOT, "dist", "framework-src");
 
 export const DEFAULT_FRAMEWORK_SOURCE_EXTENSIONS = [
@@ -37,6 +38,12 @@ export interface ResolveFrameworkSourcePathOptions {
   includeIndexFallback?: boolean;
 }
 
+export interface ResolveRelativeFrameworkSourceImportOptions {
+  fileSystem?: FrameworkSourceFileSystem;
+  exists?: (path: string) => Promise<boolean>;
+  extensions?: readonly string[];
+}
+
 export function getFrameworkSourceLookupDirs(extraLookupDirs: string[] = []): string[] {
   const seen = new Set<string>();
   const ordered = [
@@ -52,6 +59,48 @@ export function getFrameworkSourceLookupDirs(extraLookupDirs: string[] = []): st
   });
 }
 
+export function isFrameworkSourcePath(path: string): boolean {
+  return path.startsWith(`${FRAMEWORK_SRC_DIR}/`) ||
+    path.startsWith(`${FRAMEWORK_EMBEDDED_SRC_DIR}/`);
+}
+
+function expandFrameworkCandidatePaths(candidatePath: string): string[] {
+  const candidates = [candidatePath];
+  const candidateRoot = getFrameworkRoot(candidatePath);
+  const candidateSrcDir = candidateRoot ? join(candidateRoot, "src") : FRAMEWORK_SRC_DIR;
+  const candidateEmbeddedDir = candidateRoot
+    ? join(candidateRoot, "dist", "framework-src")
+    : FRAMEWORK_EMBEDDED_SRC_DIR;
+
+  if (candidatePath.startsWith(`${candidateSrcDir}/`)) {
+    const relativePath = candidatePath.slice(candidateSrcDir.length + 1);
+    candidates.push(join(candidateEmbeddedDir, relativePath));
+  }
+
+  return [...new Set(candidates)];
+}
+
+async function findExistingFrameworkCandidate(
+  candidatePath: string,
+  options: ResolveRelativeFrameworkSourceImportOptions = {},
+): Promise<string | null> {
+  const fs = options.fileSystem ?? createFileSystem();
+  const exists = options.exists ?? (async (path: string) => {
+    try {
+      const stat = await fs.stat(path);
+      return stat.isFile;
+    } catch {
+      return false;
+    }
+  });
+
+  for (const candidate of expandFrameworkCandidatePaths(candidatePath)) {
+    if (await exists(candidate)) return candidate;
+  }
+
+  return null;
+}
+
 export async function resolveFrameworkSourcePath(
   relativePathWithoutExt: string,
   options: ResolveFrameworkSourcePathOptions = {},
@@ -87,3 +136,54 @@ export async function resolveFrameworkSourcePath(
 
   return null;
 }
+
+export async function resolveRelativeFrameworkSourceImport(
+  specifier: string,
+  fromSourcePath: string,
+  options: ResolveRelativeFrameworkSourceImportOptions = {},
+): Promise<string | null> {
+  const extensions = options.extensions ?? DEFAULT_FRAMEWORK_SOURCE_EXTENSIONS;
+  const fromDir = fromSourcePath.substring(0, fromSourcePath.lastIndexOf("/"));
+  const parts = fromDir.split("/").filter(Boolean);
+  const importParts = specifier.split("/").filter(Boolean);
+
+  for (const part of importParts) {
+    if (part === "..") {
+      parts.pop();
+    } else if (part !== ".") {
+      parts.push(part);
+    }
+  }
+
+  const basePath = "/" + parts.join("/");
+
+  if (/\.(tsx?|jsx?|mjs)$/.test(specifier)) {
+    const explicitCandidates = [basePath, `${basePath}.src`];
+
+    if (basePath.endsWith(".js") || basePath.endsWith(".mjs")) {
+      const stem = basePath.replace(/\.(?:m?js)$/, "");
+      for (const ext of [".ts", ".tsx", ".jsx", ".js", ".mjs"]) {
+        explicitCandidates.push(`${stem}${ext}.src`, `${stem}${ext}`);
+      }
+    }
+
+    for (const candidate of explicitCandidates) {
+      const resolved = await findExistingFrameworkCandidate(candidate, options);
+      if (resolved) return resolved;
+    }
+
+    return null;
+  }
+
+  for (const ext of extensions) {
+    const candidate = await findExistingFrameworkCandidate(basePath + ext, options);
+    if (candidate) return candidate;
+  }
+
+  for (const ext of extensions) {
+    const candidate = await findExistingFrameworkCandidate(join(basePath, "index" + ext), options);
+    if (candidate) return candidate;
+  }
+
+  return null;
+}

package/src/src/transforms/esm/import-parser.ts

@@ -1,6 +1,10 @@
 import { getEsbuild } from "../../platform/compat/esbuild.js";
 import { join } from "../../platform/compat/path/index.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
+import {
+  isFrameworkSourcePath,
+  resolveRelativeFrameworkSourceImport,
+} from "../../platform/compat/framework-source-resolver.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import { isCrossProjectImport, parseCrossProjectImport } from "./path-resolver.js";
 import { parseImports } from "./lexer.js";
@@ -138,6 +142,14 @@ async function resolveLocalImportPath(
   importSpecifier: string,
   adapter?: RuntimeAdapter,
 ): Promise<string | null> {
+  if (isFrameworkSourcePath(fromFile)) {
+    const resolvedFrameworkImport = await resolveRelativeFrameworkSourceImport(
+      importSpecifier,
+      fromFile,
+    );
+    if (resolvedFrameworkImport) return resolvedFrameworkImport;
+  }
+
   const fromDir = fromFile.substring(0, fromFile.lastIndexOf("/"));
   const basePath = resolveRelative(fromDir, importSpecifier);
 

package/src/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.ts

@@ -8,6 +8,7 @@
 import { createFileSystem, exists } from "../../../../platform/compat/fs.js";
 import { join } from "../../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../../utils/index.js";
+import { resolveRelativeFrameworkSourceImport } from "../../../../platform/compat/framework-source-resolver.js";
 import { resolveInternalModuleTarget } from "../../../veryfront-module-urls.js";
 import {
   EMBEDDED_SRC_DIR,
@@ -201,75 +202,15 @@ export async function resolveVeryfrontSourcePath(
 export async function resolveRelativeFrameworkImport(
   specifier: string,
   fromSourcePath: string,
-  _fs: ReturnType<typeof createFileSystem>,
+  fs: ReturnType<typeof createFileSystem>,
   existsFn: (path: string) => Promise<boolean> = exists,
 ): Promise<string | null> {
-  const fromDir = fromSourcePath.substring(0, fromSourcePath.lastIndexOf("/"));
-  const parts = fromDir.split("/").filter(Boolean);
-  const importParts = specifier.split("/").filter(Boolean);
-
-  for (const part of importParts) {
-    if (part === "..") {
-      parts.pop();
-    } else if (part !== ".") {
-      parts.push(part);
-    }
-  }
-
-  const basePath = "/" + parts.join("/");
-
-  // If specifier already has extension (e.g., ./Head.tsx), we need to try:
-  // 1. The exact path (basePath)
-  // 2. The path with .src suffix (basePath.src) for embedded sources
-  // 3. For transpiled .js/.mjs imports, fall back to sibling TS/TSX/JSX sources
-  if (/\.(tsx?|jsx?|mjs)$/.test(specifier)) {
-    const explicitCandidates = [basePath, `${basePath}.src`];
-
-    // esbuild rewrites TS/TSX relative imports to .js in transformed output.
-    // When the original source only exists as .ts/.tsx (or embedded .src),
-    // probe those sibling source extensions before giving up.
-    if (basePath.endsWith(".js") || basePath.endsWith(".mjs")) {
-      const stem = basePath.replace(/\.(?:m?js)$/, "");
-      for (const ext of [".ts", ".tsx", ".jsx", ".js", ".mjs"]) {
-        explicitCandidates.push(`${stem}${ext}.src`, `${stem}${ext}`);
-      }
-    }
-
-    for (const candidate of explicitCandidates) {
-      try {
-        if (await existsFn(candidate)) return candidate;
-      } catch (_) {
-        /* expected: file may not exist at this path */
-      }
-    }
-
-    return null;
-  }
-
-  // No extension provided - try all extensions (including .src for embedded sources)
-  const allExtensions = [
-    ...EXTENSIONS.map((ext) => ext + ".src"),
-    ...EXTENSIONS,
-  ];
-
-  for (const ext of allExtensions) {
-    const pathWithExt = basePath + ext;
-    try {
-      if (await existsFn(pathWithExt)) return pathWithExt;
-    } catch (_) {
-      /* expected: file may not exist at this path */
-    }
-  }
-
-  // Try index file
-  for (const ext of allExtensions) {
-    const indexPath = join(basePath, "index" + ext);
-    try {
-      if (await existsFn(indexPath)) return indexPath;
-    } catch (_) {
-      /* expected: file may not exist at this path */
-    }
-  }
-
-  return null;
+  return await resolveRelativeFrameworkSourceImport(specifier, fromSourcePath, {
+    fileSystem: fs,
+    exists: existsFn,
+    extensions: [
+      ...EXTENSIONS.map((ext) => `${ext}.src`),
+      ...EXTENSIONS,
+    ],
+  });
 }

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.129";
+export const VERSION = "0.1.130";