@gtkx/cli 0.20.0 → 1.0.0-rc.1

package/src/vite-plugins/settings.ts

@@ -0,0 +1,221 @@
+import { mkdtempSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, join } from "node:path";
+import { error, errorMessage, info } from "@gtkx/utils";
+import type { ModuleNode, Plugin, UserConfig, ViteDevServer } from "vite";
+import { prependBanner } from "../internal/banner.js";
+import { resolveDataDir } from "../internal/data-dir.js";
+import { removeTempDir, withStagingDir } from "../internal/staging-dir.js";
+import { compileSchemas } from "../settings/compile.js";
+import { parseSchemaXml, SchemaParseError } from "../settings/parser.js";
+import { renderRuntimeModule } from "../settings/render.js";
+import { emitSchemaEnv, prependSchemaDir, SCHEMA_SUFFIX, stageSchema } from "../settings/schema.js";
+import { createVirtualNamespace } from "./virtual-module.js";
+
+const VIRTUAL_PREFIX = "\0gtkx-settings:";
+const { isVirtual, fromVirtualId, resolveToVirtual } = createVirtualNamespace(VIRTUAL_PREFIX);
+
+const SCHEMA_ENV_BANNER = [
+    `process.env.GSETTINGS_SCHEMA_DIR = [`,
+    `    decodeURIComponent(new URL(".", import.meta.url).pathname),`,
+    `    process.env.GSETTINGS_SCHEMA_DIR,`,
+    `]`,
+    `    .filter(Boolean)`,
+    `    .join(":");`,
+].join("\n");
+
+type PluginState = {
+    schemaDir: string | null;
+    rootDir: string | null;
+    dataDir: string | null;
+    isBuild: boolean;
+    trackedSchemas: Map<string, string>;
+    buildSchemas: Set<string>;
+    cleanupProcessExit: (() => void) | null;
+};
+
+type PluginContext = {
+    error: (message: string) => never;
+    emitFile: (file: { type: "asset"; fileName: string; source: Buffer }) => void;
+};
+
+const ensureSchemaDir = (state: PluginState): string => {
+    if (!state.schemaDir) {
+        const runnerDir = process.env.GTKX_DEV_SCHEMA_DIR;
+        if (runnerDir) {
+            state.schemaDir = runnerDir;
+            return runnerDir;
+        }
+        const dir = mkdtempSync(join(tmpdir(), "gtkx-schemas-"));
+        state.schemaDir = dir;
+        const cleanup = (): void => removeTempDir(dir);
+        state.cleanupProcessExit = cleanup;
+        process.once("exit", cleanup);
+    }
+    return state.schemaDir;
+};
+
+const releaseSchemaDir = (state: PluginState): void => {
+    if (!state.schemaDir) return;
+    if (state.cleanupProcessExit) {
+        removeTempDir(state.schemaDir);
+        process.removeListener("exit", state.cleanupProcessExit);
+        state.cleanupProcessExit = null;
+    }
+    state.schemaDir = null;
+};
+
+const compileSchemaDir = (state: PluginState): void => {
+    if (!state.schemaDir) return;
+    compileSchemas(state.schemaDir);
+    process.env.GSETTINGS_SCHEMA_DIR = prependSchemaDir(state.schemaDir, process.env.GSETTINGS_SCHEMA_DIR);
+};
+
+const syncSchemaEnv = (state: PluginState): void => {
+    if (state.rootDir === null) return;
+    try {
+        emitSchemaEnv(state.rootDir, state.dataDir);
+    } catch (cause) {
+        error(`Failed to generate GSettings schema types: ${errorMessage(cause)}`);
+    }
+};
+
+const registerSchemaForMode = (state: PluginState, filePath: string, id: string): void => {
+    const fileName = basename(filePath);
+    if (state.isBuild) {
+        state.buildSchemas.add(filePath);
+        info(`Queued GSettings schema: ${fileName}`);
+        return;
+    }
+    state.trackedSchemas.set(filePath, id);
+    const dir = ensureSchemaDir(state);
+    stageSchema(dir, filePath);
+    compileSchemaDir(state);
+    info(`Compiled GSettings schema: ${fileName}`);
+};
+
+const loadSchemaModule = (ctx: PluginContext, state: PluginState, id: string): string => {
+    const filePath = fromVirtualId(id);
+    const xml = readFileSync(filePath, "utf-8");
+    const fileName = basename(filePath);
+
+    registerSchemaForMode(state, filePath, id);
+
+    let parsed: ReturnType<typeof parseSchemaXml>;
+    try {
+        parsed = parseSchemaXml(xml, fileName);
+    } catch (error) {
+        if (!(error instanceof SchemaParseError)) throw error;
+        ctx.error(error.message);
+    }
+    if (parsed.schemas.length === 0) {
+        ctx.error(`No <schema id="..."> found in ${fileName}`);
+    }
+    return renderRuntimeModule(parsed);
+};
+
+const emitCompiledSchemas = (ctx: PluginContext, state: PluginState): void => {
+    if (!state.isBuild || state.buildSchemas.size === 0) return;
+
+    const compiled = withStagingDir("schemas-build", (dir) => {
+        for (const filePath of state.buildSchemas) {
+            stageSchema(dir, filePath);
+        }
+        compileSchemas(dir);
+        return readFileSync(join(dir, "gschemas.compiled"));
+    });
+    ctx.emitFile({
+        type: "asset",
+        fileName: "gschemas.compiled",
+        source: compiled,
+    });
+
+    info(`Compiled ${state.buildSchemas.size} GSettings schema(s)`);
+};
+
+const handleSchemaHotUpdate = (state: PluginState, file: string, server: ViteDevServer): ModuleNode[] | undefined => {
+    const virtualId = state.trackedSchemas.get(file);
+    if (!virtualId) return;
+
+    const dir = ensureSchemaDir(state);
+    stageSchema(dir, file);
+    compileSchemaDir(state);
+
+    info(`Recompiled GSettings schema: ${basename(file)}`);
+
+    const mod = server.moduleGraph.getModuleById(virtualId);
+    if (mod) {
+        server.moduleGraph.invalidateModule(mod);
+        return [mod];
+    }
+    return undefined;
+};
+
+const watchSchemaFiles = (state: PluginState, server: ViteDevServer): void => {
+    server.httpServer?.once("close", () => releaseSchemaDir(state));
+    server.watcher.once("close", () => releaseSchemaDir(state));
+    const refreshSchemaTypes = (file: string): void => {
+        if (file.endsWith(SCHEMA_SUFFIX)) syncSchemaEnv(state);
+    };
+    server.watcher.on("add", refreshSchemaTypes);
+    server.watcher.on("unlink", refreshSchemaTypes);
+};
+
+export function gtkxSettings(): Plugin {
+    const state: PluginState = {
+        schemaDir: null,
+        rootDir: null,
+        dataDir: null,
+        isBuild: false,
+        trackedSchemas: new Map(),
+        buildSchemas: new Set(),
+        cleanupProcessExit: null,
+    };
+
+    return {
+        name: "gtkx:settings",
+        enforce: "pre",
+
+        config(config: UserConfig) {
+            state.dataDir = resolveDataDir(config.root ?? process.cwd());
+        },
+
+        configResolved(config) {
+            state.isBuild = config.command === "build";
+            state.rootDir = typeof config.root === "string" ? config.root : null;
+            syncSchemaEnv(state);
+        },
+
+        configureServer(server) {
+            watchSchemaFiles(state, server);
+        },
+
+        outputOptions(options) {
+            if (!state.isBuild) return;
+            return prependBanner(options, SCHEMA_ENV_BANNER);
+        },
+
+        async resolveId(source, importer, options) {
+            if (!source.endsWith(SCHEMA_SUFFIX)) return;
+            return resolveToVirtual(this, { source, importer, options });
+        },
+
+        load(id) {
+            if (!isVirtual(id)) return;
+            return loadSchemaModule(this, state, id);
+        },
+
+        buildEnd() {
+            emitCompiledSchemas(this, state);
+        },
+
+        closeBundle() {
+            releaseSchemaDir(state);
+        },
+
+        handleHotUpdate({ file, server }) {
+            if (file.endsWith(SCHEMA_SUFFIX)) syncSchemaEnv(state);
+            return handleSchemaHotUpdate(state, file, server);
+        },
+    };
+}

package/src/vite-plugins/undeclared-library.ts

@@ -0,0 +1,69 @@
+import { discoverGirNamespaces, resolveGirPath } from "@gtkx/codegen";
+import { loadConfig } from "@gtkx/config";
+import type { Plugin, UserConfig } from "vite";
+
+const GENERATED_MODULE_PATTERN = /^@gtkx\/(?:gi|jsx)\/([a-z0-9]+)$/;
+
+type PluginState = {
+    root: string;
+    mode: string | undefined;
+    girPath: string[] | null;
+};
+
+const girSearchPaths = async (state: PluginState): Promise<string[]> => {
+    if (state.girPath === null) {
+        const { config } = await loadConfig(state.root, { mode: state.mode });
+        state.girPath = resolveGirPath(config.girPath);
+    }
+    return state.girPath;
+};
+
+const namespaceOf = (identifier: string): string => identifier.slice(0, identifier.indexOf("-")).toLowerCase();
+
+const findGirIdentifier = (girPath: string[], namespace: string): string | undefined =>
+    discoverGirNamespaces(girPath).find((identifier) => namespaceOf(identifier) === namespace);
+
+const undeclaredLibraryError = (source: string, namespace: string, girPath: string[]): Error => {
+    const identifier = findGirIdentifier(girPath, namespace);
+
+    if (identifier === undefined) {
+        return new Error(
+            `Cannot resolve "${source}": the binding store has no "${namespace}" module, and no GIR data for it ` +
+                `was found in [${girPath.join(", ")}]. If "${namespace}" is a library, install its ` +
+                "gobject-introspection data package and add its GIR identifier to `libraries` in gtkx.config.ts. " +
+                "Otherwise run gtkx codegen to regenerate the store.",
+        );
+    }
+
+    return new Error(
+        `Cannot resolve "${source}": the "${identifier}" bindings have not been generated. ` +
+            `Add "${identifier}" to \`libraries\` in gtkx.config.ts, then run gtkx dev or gtkx build again.`,
+    );
+};
+
+export function gtkxUndeclaredLibrary(mode?: string): Plugin {
+    const state: PluginState = {
+        root: "",
+        mode,
+        girPath: null,
+    };
+
+    return {
+        name: "gtkx:undeclared-library",
+        enforce: "pre",
+
+        config(config: UserConfig) {
+            state.root = config.root ?? process.cwd();
+        },
+
+        async resolveId(source, importer, options) {
+            const namespace = GENERATED_MODULE_PATTERN.exec(source)?.[1];
+            if (namespace === undefined) return;
+
+            const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });
+            if (resolved !== null) return;
+
+            throw undeclaredLibraryError(source, namespace, await girSearchPaths(state));
+        },
+    };
+}

package/src/vite-plugins/virtual-module.ts

@@ -0,0 +1,37 @@
+type VirtualResolveContext = {
+    resolve: (
+        source: string,
+        importer?: string,
+        options?: { skipSelf?: boolean } & Record<string, unknown>,
+    ) => Promise<{ id: string; external?: boolean | "absolute" | "relative" } | null>;
+};
+
+type VirtualResolveRequest = {
+    source: string;
+    importer: string | undefined;
+    options: Record<string, unknown> | undefined;
+};
+
+type VirtualNamespace = {
+    isVirtual: (id: string) => boolean;
+    toVirtualId: (realId: string) => string;
+    fromVirtualId: (id: string) => string;
+    resolveToVirtual: (ctx: VirtualResolveContext, request: VirtualResolveRequest) => Promise<string | undefined>;
+};
+
+export const createVirtualNamespace = (prefix: string): VirtualNamespace => {
+    const toVirtualId = (realId: string): string => prefix + realId;
+    return {
+        isVirtual: (id) => id.startsWith(prefix),
+        toVirtualId,
+        fromVirtualId: (id) => id.slice(prefix.length),
+        resolveToVirtual: async (ctx, request) => {
+            const resolved = await ctx.resolve(request.source, request.importer, {
+                ...request.options,
+                skipSelf: true,
+            });
+            if (!resolved || resolved.external) return undefined;
+            return toVirtualId(resolved.id);
+        },
+    };
+};

package/src/vitest-plugin.ts

@@ -0,0 +1,14 @@
+import gtkxVitest from "@gtkx/vitest";
+import type { Plugin } from "vite";
+import { gtkxVitePlugins } from "./vite-plugins/index.js";
+import { gtkxSettingsWorkerEnv } from "./vite-plugins/settings-worker-env.js";
+
+/**
+ * Vite plugin factory that assembles the plugins needed to run GTKX apps under Vitest,
+ * combining the shared GTKX Vite plugins with the `@gtkx/vitest` test integration.
+ *
+ * @returns The ordered array of Vite plugins to include in a Vitest configuration.
+ */
+const gtkx = (): Plugin[] => [...gtkxVitePlugins(), gtkxSettingsWorkerEnv(), gtkxVitest()];
+
+export default gtkx;

package/dist/create.d.ts

@@ -1,54 +0,0 @@
-/**
- * Supported package managers for GTKX projects.
- */
-export type PackageManager = "pnpm" | "npm" | "yarn";
-/**
- * Whether to include testing setup in GTKX projects.
- */
-export type TestingOption = "vitest" | "none";
-/**
- * Options for creating a new GTKX project.
- *
- * All options are optional; missing values will be prompted interactively.
- */
-export type CreateOptions = {
-    name?: string;
-    appId?: string;
-    packageManager?: PackageManager;
-    testing?: TestingOption;
-    claudeSkills?: boolean;
-};
-export declare const getAddCommand: (pm: PackageManager, deps: string[], dev: boolean) => string;
-export declare const getRunCommand: (pm: PackageManager) => string;
-export declare const isValidProjectName: (name: string) => boolean;
-export declare const isValidAppId: (appId: string) => boolean;
-/**
- * Creates a new GTKX project with interactive prompts.
- *
- * Scaffolds a complete project structure including:
- * - TypeScript configuration
- * - React component template
- * - Development server entry point
- * - Optional testing setup
- * - Optional Claude Code skills
- *
- * @param options - Pre-filled options to skip prompts
- *
- * @example
- * ```tsx
- * import { createApp } from "@gtkx/cli";
- *
- * // Interactive mode
- * await createApp();
- *
- * // With pre-filled options
- * await createApp({
- *   name: "my-app",
- *   appId: "com.example.myapp",
- *   packageManager: "pnpm",
- *   testing: "vitest",
- * });
- * ```
- */
-export declare const createApp: (options?: CreateOptions) => Promise<void>;
-//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAiBF,eAAO,MAAM,aAAa,GAAI,IAAI,cAAc,EAAE,MAAM,MAAM,EAAE,EAAE,KAAK,OAAO,KAAG,MAYhF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,IAAI,cAAc,KAAG,MASlD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OAEjD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAE5C,CAAC;AA+LF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,SAAS,GAAU,UAAS,aAAkB,KAAG,OAAO,CAAC,IAAI,CAezE,CAAC"}

package/dist/create.js

@@ -1,221 +0,0 @@
-import { spawn } from "node:child_process";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import * as p from "@clack/prompts";
-import { renderFile } from "./templates.js";
-const DEPENDENCIES = ["@gtkx/css", "@gtkx/ffi", "@gtkx/react", "react"];
-const DEV_DEPENDENCIES = ["@gtkx/cli", "@types/react", "typescript", "vite"];
-const TESTING_DEV_DEPENDENCIES = ["@gtkx/testing", "@gtkx/vitest", "vitest"];
-const createTemplateContext = (name, appId, testing) => {
-    const title = name
-        .split("-")
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(" ");
-    return { name, appId, title, testing };
-};
-export const getAddCommand = (pm, deps, dev) => {
-    const devFlag = dev ? (pm === "npm" ? "--save-dev" : "-D") : "";
-    const parts = [devFlag, ...deps].filter(Boolean).join(" ");
-    switch (pm) {
-        case "npm":
-            return `npm install ${parts}`;
-        case "yarn":
-            return `yarn add ${parts}`;
-        case "pnpm":
-            return `pnpm add ${parts}`;
-    }
-};
-export const getRunCommand = (pm) => {
-    switch (pm) {
-        case "npm":
-            return "npm run dev";
-        case "yarn":
-            return "yarn dev";
-        case "pnpm":
-            return "pnpm dev";
-    }
-};
-export const isValidProjectName = (name) => {
-    return /^[a-z0-9-]+$/.test(name);
-};
-export const isValidAppId = (appId) => {
-    return /^[a-zA-Z][a-zA-Z0-9]*(\.[a-zA-Z][a-zA-Z0-9]*)+$/.test(appId);
-};
-const runCommand = (command, cwd) => {
-    return new Promise((resolve, reject) => {
-        const proc = spawn(command, { cwd, stdio: "pipe", shell: true });
-        proc.on("close", (code) => code === 0 ? resolve() : reject(new Error(`Command failed with exit code ${code}`)));
-        proc.on("error", reject);
-    });
-};
-const suggestAppId = (name) => {
-    const sanitized = name.replace(/-/g, "");
-    return `com.${sanitized}.app`;
-};
-const checkCancelled = (value) => {
-    if (p.isCancel(value)) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-    }
-    return value;
-};
-const promptForOptions = async (options) => {
-    const name = options.name ??
-        checkCancelled(await p.text({
-            message: "Project name",
-            placeholder: "my-app",
-            validate: (value) => {
-                if (!value)
-                    return "Project name is required";
-                if (!isValidProjectName(value)) {
-                    return "Project name must be lowercase letters, numbers, and hyphens only";
-                }
-                if (existsSync(resolve(process.cwd(), value))) {
-                    return `Directory "${value}" already exists`;
-                }
-            },
-        }));
-    const defaultAppId = suggestAppId(name);
-    const appId = options.appId ??
-        checkCancelled(await p.text({
-            message: "App ID",
-            placeholder: defaultAppId,
-            initialValue: defaultAppId,
-            validate: (value) => {
-                if (!value)
-                    return "App ID is required";
-                if (!isValidAppId(value)) {
-                    return "App ID must be reverse domain notation (e.g., com.example.myapp)";
-                }
-            },
-        }));
-    const packageManager = options.packageManager ??
-        checkCancelled(await p.select({
-            message: "Package manager",
-            options: [
-                { value: "pnpm", label: "pnpm", hint: "recommended" },
-                { value: "npm", label: "npm" },
-                { value: "yarn", label: "yarn" },
-            ],
-            initialValue: "pnpm",
-        }));
-    const testing = options.testing ??
-        (checkCancelled(await p.confirm({
-            message: "Include testing setup (Vitest)?",
-            initialValue: true,
-        }))
-            ? "vitest"
-            : "none");
-    const claudeSkills = options.claudeSkills ??
-        checkCancelled(await p.confirm({
-            message: "Include Claude Code skills?",
-            initialValue: true,
-        }));
-    return { name, appId, packageManager, testing, claudeSkills };
-};
-const scaffoldProject = (projectPath, resolved) => {
-    const { name, appId, testing, claudeSkills } = resolved;
-    const context = createTemplateContext(name, appId, testing);
-    mkdirSync(projectPath, { recursive: true });
-    mkdirSync(join(projectPath, "src"), { recursive: true });
-    if (testing !== "none") {
-        mkdirSync(join(projectPath, "tests"), { recursive: true });
-    }
-    writeFileSync(join(projectPath, "package.json"), renderFile("package.json.ejs", context));
-    writeFileSync(join(projectPath, "tsconfig.json"), renderFile("tsconfig.json.ejs", context));
-    writeFileSync(join(projectPath, "src", "app.tsx"), renderFile("src/app.tsx.ejs", context));
-    writeFileSync(join(projectPath, "src", "dev.tsx"), renderFile("src/dev.tsx.ejs", context));
-    writeFileSync(join(projectPath, "src", "index.tsx"), renderFile("src/index.tsx.ejs", context));
-    writeFileSync(join(projectPath, "src", "gtkx-env.d.ts"), renderFile("src/gtkx-env.d.ts.ejs", context));
-    writeFileSync(join(projectPath, ".gitignore"), renderFile("gitignore.ejs", context));
-    if (claudeSkills) {
-        const skillsDir = join(projectPath, ".claude", "skills", "developing-gtkx-apps");
-        mkdirSync(skillsDir, { recursive: true });
-        writeFileSync(join(skillsDir, "SKILL.md"), renderFile("claude/SKILL.md.ejs", context));
-        writeFileSync(join(skillsDir, "WIDGETS.md"), renderFile("claude/WIDGETS.md.ejs", context));
-        writeFileSync(join(skillsDir, "EXAMPLES.md"), renderFile("claude/EXAMPLES.md.ejs", context));
-    }
-    if (testing === "vitest") {
-        writeFileSync(join(projectPath, "vitest.config.ts"), renderFile("config/vitest.config.ts.ejs", context));
-        writeFileSync(join(projectPath, "tests", "app.test.tsx"), renderFile("tests/app.test.tsx.ejs", context));
-    }
-};
-const getDevDependencies = (testing) => {
-    const devDeps = [...DEV_DEPENDENCIES];
-    if (testing === "vitest") {
-        devDeps.push(...TESTING_DEV_DEPENDENCIES);
-    }
-    return devDeps;
-};
-const installDependencies = async (projectPath, name, packageManager, devDeps) => {
-    const installSpinner = p.spinner();
-    installSpinner.start("Installing dependencies...");
-    try {
-        const addCmd = getAddCommand(packageManager, DEPENDENCIES, false);
-        await runCommand(addCmd, projectPath);
-        const addDevCmd = getAddCommand(packageManager, devDeps, true);
-        await runCommand(addDevCmd, projectPath);
-        installSpinner.stop("Dependencies installed!");
-    }
-    catch (error) {
-        installSpinner.stop("Failed to install dependencies");
-        p.log.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
-        p.log.info("You can install dependencies manually by running:");
-        p.log.info(`  cd ${name}`);
-        p.log.info(`  ${getAddCommand(packageManager, DEPENDENCIES, false)}`);
-        p.log.info(`  ${getAddCommand(packageManager, devDeps, true)}`);
-    }
-};
-const printNextSteps = (name, packageManager, testing) => {
-    const runCmd = getRunCommand(packageManager);
-    const nextSteps = `cd ${name}\n${runCmd}`;
-    const testingNote = testing !== "none"
-        ? `
-
-To run tests, you need xvfb installed:
-  Fedora: sudo dnf install xorg-x11-server-Xvfb
-  Ubuntu: sudo apt install xvfb`
-        : "";
-    p.note(`${nextSteps}${testingNote}`, "Next steps");
-};
-/**
- * Creates a new GTKX project with interactive prompts.
- *
- * Scaffolds a complete project structure including:
- * - TypeScript configuration
- * - React component template
- * - Development server entry point
- * - Optional testing setup
- * - Optional Claude Code skills
- *
- * @param options - Pre-filled options to skip prompts
- *
- * @example
- * ```tsx
- * import { createApp } from "@gtkx/cli";
- *
- * // Interactive mode
- * await createApp();
- *
- * // With pre-filled options
- * await createApp({
- *   name: "my-app",
- *   appId: "com.example.myapp",
- *   packageManager: "pnpm",
- *   testing: "vitest",
- * });
- * ```
- */
-export const createApp = async (options = {}) => {
-    p.intro("Create GTKX App");
-    const resolved = await promptForOptions(options);
-    const projectPath = resolve(process.cwd(), resolved.name);
-    const s = p.spinner();
-    s.start("Creating project structure...");
-    scaffoldProject(projectPath, resolved);
-    s.stop("Project structure created!");
-    const devDeps = getDevDependencies(resolved.testing);
-    await installDependencies(projectPath, resolved.name, resolved.packageManager, devDeps);
-    printNextSteps(resolved.name, resolved.packageManager, resolved.testing);
-};
-//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"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"}

package/dist/dev-server.d.ts

@@ -1,38 +0,0 @@
-import { type InlineConfig, type ViteDevServer } from "vite";
-/**
- * Options for the GTKX development server.
- */
-export type DevServerOptions = {
-    /** Path to the entry file (e.g., "src/dev.tsx") */
-    entry: string;
-    /** Additional Vite configuration */
-    vite?: InlineConfig;
-};
-/**
- * Creates a Vite-based development server with hot module replacement.
- *
- * Provides fast refresh for React components and full reload for other changes.
- * The server watches for file changes and automatically updates the running
- * GTK application.
- *
- * @param options - Server configuration including entry point and Vite options
- * @returns A Vite development server instance
- *
- * @example
- * ```tsx
- * import { createDevServer } from "@gtkx/cli";
- * import { render } from "@gtkx/react";
- *
- * const server = await createDevServer({
- * entry: "./src/dev.tsx",
- * });
- *
- * const mod = await server.ssrLoadModule("./src/dev.tsx");
- * render(<mod.default />, mod.appId);
- * ```
- *
- * @see {@link DevServerOptions} for configuration options
- */
-export declare const createDevServer: (options: DevServerOptions) => Promise<ViteDevServer>;
-export type { ViteDevServer };
-//# sourceMappingURL=dev-server.d.ts.map

package/dist/dev-server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAM3E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,aAAa,CAgHtF,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,CAAC"}