create-gtkx 0.21.0 → 1.0.0-rc.2

package/README.md

@@ -0,0 +1,173 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
+</p>
+
+<h1 align="center">GTKX</h1>
+
+<p align="center">
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
+</p>
+
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
+
+## Demo
+
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+
+```tsx
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
+import { useState } from "react";
+
+const Counter = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
+        valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
+      >
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
+```
+
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
+
+## Why GTKX
+
+### A declarative layer for the GNOME stack
+
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
+
+### The full GNOME API surface
+
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+
+### Why Node.js, and why generated bindings
+
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
+
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
+
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
+
+## Quick start
+
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+
+Scaffold a new app with the `create-gtkx` initializer:
+
+```sh
+npm create gtkx@rc
+```
+
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
+
+```sh
+cd my-app
+npm run dev
+```
+
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
+
+## Documentation
+
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
+
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
+
+## Requirements
+
+GTKX is Linux-only. You need:
+
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
+
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
+
+## License
+
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/bin/create-gtkx.js

@@ -1,5 +1,2 @@
 #!/usr/bin/env node
-import { runMain } from "citty";
-import { main } from "../dist/cli.js";
-
-runMain(main);
+import "../dist/cli.js";

package/dist/cli.d.ts

@@ -1,24 +1,2 @@
-export declare const main: import("citty").CommandDef<{
-    name: {
-        type: "positional";
-        description: string;
-        required: false;
-    };
-    "application-id": {
-        type: "string";
-        description: string;
-    };
-    pm: {
-        type: "string";
-        description: string;
-    };
-    testing: {
-        type: "string";
-        description: string;
-    };
-    "claude-skills": {
-        type: "boolean";
-        description: string;
-    };
-}>;
+export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;EAQf,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,19 +1,14 @@
-import { createRequire } from "node:module";
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { packageVersion } from "@gtkx/utils";
 import { defineCommand, runMain } from "citty";
-import { createCommandArgs, runCreate } from "./command.js";
-const { version } = createRequire(import.meta.url)("../package.json");
-export const main = defineCommand({
+import { scaffoldCommand } from "./command.js";
+const version = packageVersion(import.meta.url);
+const main = defineCommand({
+    ...scaffoldCommand,
     meta: {
         name: "create-gtkx",
         version,
         description: "Scaffold a new GTKX application",
     },
-    args: createCommandArgs,
-    run: ({ args }) => runCreate(args),
 });
-if (process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])) {
-    void runMain(main);
-}
+void runMain(main);
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE7F,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;IAC9B,IAAI,EAAE;QACF,IAAI,EAAE,aAAa;QACnB,OAAO;QACP,WAAW,EAAE,iCAAiC;KACjD;IACD,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC;AAEH,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD,MAAM,IAAI,GAAG,aAAa,CAAC;IACvB,GAAG,eAAe;IAClB,IAAI,EAAE;QACF,IAAI,EAAE,aAAa;QACnB,OAAO;QACP,WAAW,EAAE,iCAAiC;KACjD;CACJ,CAAC,CAAC;AAEH,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC","sourcesContent":["import { packageVersion } from \"@gtkx/utils\";\nimport { defineCommand, runMain } from \"citty\";\nimport { scaffoldCommand } from \"./command.js\";\n\nconst version = packageVersion(import.meta.url);\n\nconst main = defineCommand({\n    ...scaffoldCommand,\n    meta: {\n        name: \"create-gtkx\",\n        version,\n        description: \"Scaffold a new GTKX application\",\n    },\n});\n\nvoid runMain(main);\n"]}

package/dist/command.d.ts

@@ -1,65 +1,58 @@
-/** Raw, unparsed command-line arguments accepted by the create command. */
-export type CreateCommandArgs = {
+type CreateCommandArgs = {
     name?: string | undefined;
     "application-id"?: string | undefined;
-    pm?: string | undefined;
-    testing?: string | undefined;
-    "claude-skills"?: boolean | undefined;
+    "package-manager"?: string | undefined;
+    typescript?: boolean | undefined;
+    vitest?: boolean | undefined;
+    yes?: boolean | undefined;
+    "no-interactive"?: boolean | undefined;
+    overwrite?: boolean | undefined;
 };
 /**
- * Shared citty argument schema for both the standalone `create-gtkx` binary and
- * the `gtkx create` subcommand.
+ * Citty command definition for the CLI `create` subcommand. It declares the
+ * scaffolder's arguments (target name, application ID, package manager,
+ * TypeScript and Vitest toggles, prompt behavior, and overwrite) and runs the
+ * scaffolder to generate a new GTKX application.
  */
-export declare const createCommandArgs: {
-    name: {
-        type: "positional";
-        description: string;
-        required: false;
-    };
-    "application-id": {
-        type: "string";
-        description: string;
-    };
-    pm: {
-        type: "string";
-        description: string;
-    };
-    testing: {
-        type: "string";
-        description: string;
-    };
-    "claude-skills": {
-        type: "boolean";
-        description: string;
-    };
-};
-/**
- * Normalize raw create arguments and scaffold the application. Throws on an
- * unknown package manager or testing option before any files are written.
- */
-export declare const runCreate: (args: CreateCommandArgs) => Promise<void>;
-/** The `gtkx create` subcommand: scaffold a new gtkx application. */
-export declare const createCommand: import("citty").CommandDef<{
-    name: {
-        type: "positional";
-        description: string;
-        required: false;
-    };
-    "application-id": {
-        type: "string";
-        description: string;
-    };
-    pm: {
-        type: "string";
-        description: string;
-    };
-    testing: {
-        type: "string";
-        description: string;
-    };
-    "claude-skills": {
-        type: "boolean";
-        description: string;
+declare const scaffoldCommand: import("citty").CommandDef<{
+    readonly name: {
+        readonly type: "positional";
+        readonly description: "Target directory or project name (e.g. my-app, ., apps/my-app)";
+        readonly required: false;
+    };
+    readonly "application-id": {
+        readonly type: "string";
+        readonly description: "Application ID (e.g., com.example.myapp)";
+    };
+    readonly "package-manager": {
+        readonly type: "string";
+        readonly alias: "pm";
+        readonly description: string;
+    };
+    readonly typescript: {
+        readonly type: "boolean";
+        readonly negativeDescription: "Scaffold the application in JavaScript instead of TypeScript";
+        readonly description: "Scaffold the application in TypeScript";
+    };
+    readonly vitest: {
+        readonly type: "boolean";
+        readonly description: "Include a Vitest testing setup";
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly alias: "y";
+        readonly description: "Skip prompts and accept defaults for unspecified options";
+    };
+    readonly "no-interactive": {
+        readonly type: "boolean";
+        readonly description: string;
+    };
+    readonly overwrite: {
+        readonly type: "boolean";
+        readonly alias: "force";
+        readonly description: "Overwrite the contents of a non-empty target directory when running without prompts";
     };
 }>;
+declare const runCreate: (args: CreateCommandArgs) => Promise<void>;
+export { scaffoldCommand, runCreate, type CreateCommandArgs };
 //# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAWA,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAsBX,CAAC;AAkBpB;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAU,MAAM,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAQrE,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAKA,KAAK,iBAAiB,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CnB,CAAC;AA4BH,QAAA,MAAM,SAAS,GAAU,MAAM,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAiB9D,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,CAAC"}

package/dist/command.js

@@ -1,69 +1,96 @@
 import { defineCommand } from "citty";
-import { createApp } from "./create.js";
-import { isKnownPackageManager, isTestingOption, PACKAGE_MANAGER_FLAG_DESCRIPTION, TESTING_FLAG_DESCRIPTION, } from "./options.js";
+import { OperationCanceledError, ScaffoldAbortedError } from "./errors.js";
+import { isKnownPackageManager, PACKAGE_MANAGER_FLAG_DESCRIPTION } from "./package-managers.js";
+import { scaffold } from "./scaffolder.js";
 /**
- * Shared citty argument schema for both the standalone `create-gtkx` binary and
- * the `gtkx create` subcommand.
+ * Citty command definition for the CLI `create` subcommand. It declares the
+ * scaffolder's arguments (target name, application ID, package manager,
+ * TypeScript and Vitest toggles, prompt behavior, and overwrite) and runs the
+ * scaffolder to generate a new GTKX application.
  */
-export const createCommandArgs = {
-    name: {
-        type: "positional",
-        description: "Project name",
-        required: false,
-    },
-    "application-id": {
-        type: "string",
-        description: "Application ID (e.g., com.example.myapp)",
-    },
-    pm: {
-        type: "string",
-        description: PACKAGE_MANAGER_FLAG_DESCRIPTION,
-    },
-    testing: {
-        type: "string",
-        description: TESTING_FLAG_DESCRIPTION,
+const scaffoldCommand = defineCommand({
+    meta: {
+        name: "create",
+        description: "Create a new GTKX application",
     },
-    "claude-skills": {
-        type: "boolean",
-        description: "Include Claude Code skills for AI assistance",
+    args: {
+        name: {
+            type: "positional",
+            description: "Target directory or project name (e.g. my-app, ., apps/my-app)",
+            required: false,
+        },
+        "application-id": {
+            type: "string",
+            description: "Application ID (e.g., com.example.myapp)",
+        },
+        "package-manager": {
+            type: "string",
+            alias: "pm",
+            description: PACKAGE_MANAGER_FLAG_DESCRIPTION,
+        },
+        typescript: {
+            type: "boolean",
+            negativeDescription: "Scaffold the application in JavaScript instead of TypeScript",
+            description: "Scaffold the application in TypeScript",
+        },
+        vitest: {
+            type: "boolean",
+            description: "Include a Vitest testing setup",
+        },
+        yes: {
+            type: "boolean",
+            alias: "y",
+            description: "Skip prompts and accept defaults for unspecified options",
+        },
+        "no-interactive": {
+            type: "boolean",
+            description: "Run without prompts, using the default for every option not passed on the command line " +
+                "(same as --yes)",
+        },
+        overwrite: {
+            type: "boolean",
+            alias: "force",
+            description: "Overwrite the contents of a non-empty target directory when running without prompts",
+        },
     },
-};
+    run: ({ args }) => runCreate(args),
+});
 const parsePackageManager = (value) => {
-    if (value === undefined)
+    if (value === undefined) {
         return undefined;
+    }
     if (!isKnownPackageManager(value)) {
         throw new Error(`Unknown package manager "${value}". Expected one of: ${PACKAGE_MANAGER_FLAG_DESCRIPTION}.`);
     }
     return value;
 };
-const parseTestingOption = (value) => {
-    if (value === undefined)
-        return undefined;
-    if (!isTestingOption(value)) {
-        throw new Error(`Unknown testing setup "${value}". Expected one of: ${TESTING_FLAG_DESCRIPTION}.`);
+const settleScaffoldFailure = (error) => {
+    if (error instanceof OperationCanceledError) {
+        return;
     }
-    return value;
+    if (error instanceof ScaffoldAbortedError) {
+        process.exitCode = 1;
+        return;
+    }
+    throw error;
 };
-/**
- * Normalize raw create arguments and scaffold the application. Throws on an
- * unknown package manager or testing option before any files are written.
- */
-export const runCreate = async (args) => {
-    await createApp({
-        name: args.name,
-        applicationId: args["application-id"],
-        packageManager: parsePackageManager(args.pm),
-        testing: parseTestingOption(args.testing),
-        claudeSkills: args["claude-skills"],
-    });
+const runCreate = async (args) => {
+    const isInteractive = args["no-interactive"] || args.yes ? false : process.stdin.isTTY;
+    const packageManager = parsePackageManager(args["package-manager"]);
+    try {
+        await scaffold({
+            name: args.name,
+            applicationId: args["application-id"],
+            packageManager,
+            typescript: args.typescript,
+            includeTesting: args.vitest,
+            interactive: isInteractive,
+            overwrite: args.overwrite,
+        });
+    }
+    catch (error) {
+        settleScaffoldFailure(error);
+    }
 };
-/** The `gtkx create` subcommand: scaffold a new gtkx application. */
-export const createCommand = defineCommand({
-    meta: {
-        name: "create",
-        description: "Create a new GTKX application",
-    },
-    args: createCommandArgs,
-    run: ({ args }) => runCreate(args),
-});
+export { scaffoldCommand, runCreate };
 //# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,aAAa,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACH,qBAAqB,EACrB,eAAe,EACf,gCAAgC,EAEhC,wBAAwB,GAE3B,MAAM,cAAc,CAAC;AAWtB;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,IAAI,EAAE;QACF,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,KAAK;KAClB;IACD,gBAAgB,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0CAA0C;KAC1D;IACD,EAAE,EAAE;QACA,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gCAAgC;KAChD;IACD,OAAO,EAAE;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wBAAwB;KACxC;IACD,eAAe,EAAE;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;KAC9D;CACc,CAAC;AAEpB,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAA8B,EAAE;IAClF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,uBAAuB,gCAAgC,GAAG,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAyB,EAA6B,EAAE;IAChF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,uBAAuB,wBAAwB,GAAG,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAuB,EAAiB,EAAE;IACtE,MAAM,SAAS,CAAC;QACZ,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACrC,cAAc,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;KACtC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;KAC/C;IACD,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineCommand } from \"citty\";\nimport { OperationCanceledError, ScaffoldAbortedError } from \"./errors.js\";\nimport { isKnownPackageManager, PACKAGE_MANAGER_FLAG_DESCRIPTION, type PackageManager } from \"./package-managers.js\";\nimport { scaffold } from \"./scaffolder.js\";\n\ntype CreateCommandArgs = {\n    name?: string | undefined;\n    \"application-id\"?: string | undefined;\n    \"package-manager\"?: string | undefined;\n    typescript?: boolean | undefined;\n    vitest?: boolean | undefined;\n    yes?: boolean | undefined;\n    \"no-interactive\"?: boolean | undefined;\n    overwrite?: boolean | undefined;\n};\n\n/**\n * Citty command definition for the CLI `create` subcommand. It declares the\n * scaffolder's arguments (target name, application ID, package manager,\n * TypeScript and Vitest toggles, prompt behavior, and overwrite) and runs the\n * scaffolder to generate a new GTKX application.\n */\nconst scaffoldCommand = defineCommand({\n    meta: {\n        name: \"create\",\n        description: \"Create a new GTKX application\",\n    },\n    args: {\n        name: {\n            type: \"positional\",\n            description: \"Target directory or project name (e.g. my-app, ., apps/my-app)\",\n            required: false,\n        },\n        \"application-id\": {\n            type: \"string\",\n            description: \"Application ID (e.g., com.example.myapp)\",\n        },\n        \"package-manager\": {\n            type: \"string\",\n            alias: \"pm\",\n            description: PACKAGE_MANAGER_FLAG_DESCRIPTION,\n        },\n        typescript: {\n            type: \"boolean\",\n            negativeDescription: \"Scaffold the application in JavaScript instead of TypeScript\",\n            description: \"Scaffold the application in TypeScript\",\n        },\n        vitest: {\n            type: \"boolean\",\n            description: \"Include a Vitest testing setup\",\n        },\n        yes: {\n            type: \"boolean\",\n            alias: \"y\",\n            description: \"Skip prompts and accept defaults for unspecified options\",\n        },\n        \"no-interactive\": {\n            type: \"boolean\",\n            description:\n                \"Run without prompts, using the default for every option not passed on the command line \" +\n                \"(same as --yes)\",\n        },\n        overwrite: {\n            type: \"boolean\",\n            alias: \"force\",\n            description: \"Overwrite the contents of a non-empty target directory when running without prompts\",\n        },\n    },\n    run: ({ args }) => runCreate(args),\n});\n\nconst parsePackageManager = (value: string | undefined): PackageManager | undefined => {\n    if (value === undefined) {\n        return undefined;\n    }\n\n    if (!isKnownPackageManager(value)) {\n        throw new Error(`Unknown package manager \"${value}\". Expected one of: ${PACKAGE_MANAGER_FLAG_DESCRIPTION}.`);\n    }\n\n    return value;\n};\n\nconst settleScaffoldFailure = (error: unknown): void => {\n    if (error instanceof OperationCanceledError) {\n        return;\n    }\n\n    if (error instanceof ScaffoldAbortedError) {\n        process.exitCode = 1;\n\n        return;\n    }\n\n    throw error;\n};\n\nconst runCreate = async (args: CreateCommandArgs): Promise<void> => {\n    const isInteractive = args[\"no-interactive\"] || args.yes ? false : process.stdin.isTTY;\n    const packageManager = parsePackageManager(args[\"package-manager\"]);\n\n    try {\n        await scaffold({\n            name: args.name,\n            applicationId: args[\"application-id\"],\n            packageManager,\n            typescript: args.typescript,\n            includeTesting: args.vitest,\n            interactive: isInteractive,\n            overwrite: args.overwrite,\n        });\n    } catch (error) {\n        settleScaffoldFailure(error);\n    }\n};\n\nexport { scaffoldCommand, runCreate, type CreateCommandArgs };\n"]}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+declare class ScaffoldAbortedError extends Error {
+    constructor(message: string);
+}
+declare class OperationCanceledError extends Error {
+    constructor();
+}
+export { OperationCanceledError, ScaffoldAbortedError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,cAAM,oBAAqB,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI9B;AAED,cAAM,sBAAuB,SAAQ,KAAK;;CAKzC;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/errors.js

@@ -0,0 +1,14 @@
+class ScaffoldAbortedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ScaffoldAbortedError";
+    }
+}
+class OperationCanceledError extends Error {
+    constructor() {
+        super("Operation canceled");
+        this.name = "OperationCanceledError";
+    }
+}
+export { OperationCanceledError, ScaffoldAbortedError };
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAqB,SAAQ,KAAK;IACpC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAED,MAAM,sBAAuB,SAAQ,KAAK;IACtC;QACI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACzC,CAAC;CACJ;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["class ScaffoldAbortedError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ScaffoldAbortedError\";\n    }\n}\n\nclass OperationCanceledError extends Error {\n    constructor() {\n        super(\"Operation canceled\");\n        this.name = \"OperationCanceledError\";\n    }\n}\n\nexport { OperationCanceledError, ScaffoldAbortedError };\n"]}

package/dist/index.d.ts

@@ -1,5 +1,2 @@
-export { createCommand, createCommandArgs, type CreateCommandArgs, runCreate } from "./command.js";
-export { createApp } from "./create.js";
-export { isKnownPackageManager, isTestingOption, type PackageManager, type TestingOption } from "./options.js";
-export type { CreateOptions } from "./scaffolder.js";
+export { scaffoldCommand } from "./command.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/G,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,4 +1,2 @@
-export { createCommand, createCommandArgs, runCreate } from "./command.js";
-export { createApp } from "./create.js";
-export { isKnownPackageManager, isTestingOption } from "./options.js";
+export { scaffoldCommand } from "./command.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0B,SAAS,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAA2C,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { scaffoldCommand } from \"./command.js\";\n"]}

package/dist/package-managers.d.ts

@@ -0,0 +1,24 @@
+type PackageManager = (typeof PACKAGE_MANAGERS)[number]["value"];
+declare const PACKAGE_MANAGERS: readonly [{
+    readonly value: "pnpm";
+    readonly label: "pnpm";
+    readonly devCommand: "pnpm dev";
+    readonly installCommand: "pnpm install";
+    readonly recommended: true;
+}, {
+    readonly value: "npm";
+    readonly label: "npm";
+    readonly devCommand: "npm run dev";
+    readonly installCommand: "npm install";
+    readonly recommended: false;
+}, {
+    readonly value: "yarn";
+    readonly label: "yarn";
+    readonly devCommand: "yarn dev";
+    readonly installCommand: "yarn install";
+    readonly recommended: false;
+}];
+declare const PACKAGE_MANAGER_FLAG_DESCRIPTION: string;
+declare const isKnownPackageManager: (name: string) => name is PackageManager;
+export { PACKAGE_MANAGERS, PACKAGE_MANAGER_FLAG_DESCRIPTION, isKnownPackageManager, type PackageManager };
+//# sourceMappingURL=package-managers.d.ts.map

package/dist/package-managers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-managers.d.ts","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAEjE,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAIZ,CAAC;AAGX,QAAA,MAAM,gCAAgC,QAA2D,CAAC;AAElG,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,cACC,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,CAAC"}